NAME

sec_rgy_site_get-Returns the string representation for a bound registry site

SYNOPSIS

#include <dce/binding.h>

void sec_rgy_site_get(
    sec_rgy_handle_t context,
    unsigned_char_t **site_name,
    error_status_t *status);

PARAMETERS

Input

context

An opaque handle indicating (bound to) a registry server. Use sec_rgy_site_open() to acquire a bound handle. To obtain information on the default binding handle, initialize context to sec_rgy_default_handle. A valid login context must be set for the process if context is set to sec_rgy_default_handle; otherwise the error sec_login_s_no_current_context is returned.

Output

site_name

A pointer to a character string (type unsigned_char_t) containing the returned name of the registry site associated with context, the given registry server handle.

The name is either a global name or a network address, depending on the form in which the name was input to the call that bound to the site.

status

A pointer to the completion status. On successful completion, the routine returns error_status_ok. Otherwise, it returns an error.

DESCRIPTION

The sec_rgy_site_get() routine returns the name of the registry site associated with the specified handle. If the handle is the default context, the routine returns the name of the default context's site. Memory is allocated for the string returned in the site_name parameter. The application calls the rpc_string_free() routine to deallocate that memory.

NOTES

To obtain binding information, the use of the sec_rgy_site_binding_get_info() call is recommended in place of this call.

FILES

/usr/include/dce/binding.idl

The idl file from which dce/binding.h was derived.

ERRORS

error_status_ok

The call was successful.

sec_login_s_no_current_context

No currently established network identity for which context exists.

sec_rgy_server_unavailable

Server unavailable.

SEE ALSO

Functions: sec_rgy_site_open().