Previous section.

DCE 1.1: Authentication and Security Services
Copyright © 1997 The Open Group

NAME

sec_rgy_site_binding_get_info-Returns information from the registry binding handle

SYNOPSIS

#include <dce/binding.h>

void sec_rgy_site_binding_get_info(
    sec_rgy_handle_t context,
    unsigned_char_t **cell_name,
    unsigned_char_t **server_name,
    unsigned_char_t **string_binding,
    sec_rgy_bind_auth_info_t *auth_info,
    error_status_t *status);

PARAMETERS

Input

context

A sec_rgy_handle_t variable that contains a registry server handle indicating (bound to) the desired registry site. 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

cell_name

The name of the home cell for this registry.

server_name

The name of the node on which the server is resident. This 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.

string_binding

A string containing binding information from sec_rgy_handle_t.

auth_info

A pointer to the sec_rgy_bind_auth_info_t structure that identifies the authentication protocol, protection level, and authorization protocol to use in establishing the binding. (See the rpc_binding_set_auth_info() routine).

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_binding_get_info() routine returns the site name and authentication information associated with the context parameter. If the context is the default context, the information for the default binding is returned. Passing in a NULL value for any of the output values (except for status) will prevent that value from being returned. Memory is allocated for the string returned in the cell_name, server_name, and string_binding parameters. The application calls the rpc_string_free() routine to deallocate that memory.


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(), sec_rgy_site_bind().
Please note that the html version of this specification may contain formatting aberrations. The definitive version is available as an electronic publication on CD-ROM from The Open Group.

Contents Next section Index