Output privs Returns an opaque handle to the authorisation or privilege information for the client that made the remote procedure call on binding . The lifetime of the data referenced by this argument is one invocation of a server manager routine. This status code indicates whether the routine completed successfully or, if not, why not. Binding has no authentication information. The calling server manager routine can use the returned data for authorisation purposes.
Servers obtain client binding handles as the first argument of a remote procedure call.
The client binding handle references authentication, authorisation and privilege information for the client that made the remote procedure call. When the client makes an RPC call on this server binding handle, the client binding handle received by the server references the same authentication, authorisation and privilege information. No application memory is allocated for the data referenced by privs . The lifetime of this data is the current invocation of the manager routine that was called with the binding argument. An application that wishes to preserve any privileges information beyond this invocation must copy the information into application-allocated memory.