sec_rgy_site_get(3sec)
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_under_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
The following describes a partial list of errors that might be returned. Refer to the OSF DCE Problem Determination Guide for complete descriptions of all error messages.
sec_under_login_s_no_current_context
sec_rgy_server_unavailable
The requested registry server is not available.
error_status_ok
The call was successful.
Related Information
Functions: