Previous section.

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

NAME

fsec_acl_bind_to_addr-Obtain ("bind") handle to a protected object identified by address and name.

SYNOPSIS

#include <dce/daclif.h>

void sec_acl_bind_to_addr(
    unsigned char *addr,
    sec_acl_component_name_t component_name,
    sec_acl_handle_t *prot_obj_handle,
    error_status_t *status);

PARAMETERS

Input

addr

Fully qualified RPC string binding ("address") to the server managing the protected object to which a security handle is desired.

component_name

Server-supported namespace name of the protected object to which a security handle is desired.

Output

prot_obj_handle

Handle to the specified protected object.

status

Completion status. On successful completion, error_status_ok is returned. Otherwise, an error (!= error_status_ok) is returned.

DESCRIPTION

The sec_acl_bind_to_addr() routine is identical to sec_acl_bind(), except that it identifies the protected object by server address and server-supported name (addr and component_name), instead of by full name.

NOTES

Unlike sec_acl_bind(), there can be no ambiguity about the protected object that sec_acl_bind_to_addr() refers to, because the target server is referred to unambiguously by its address (RPC string binding).

ERRORS

error_status_ok, sec_acl_object_not_found, sec_acl_no_acl_found, sec_acl_unable_to_authenticate, sec_acl_bind_error, sec_acl_invalid_site_name, sec_acl_cant_allocate_memory.

SEE ALSO

Functions: sec_acl_bind(), sec_acl_release_handle().
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