RPC_MGMT_AUTHORIZATION_FN callback function (rpcdce.h)
The RPC_MGMT_AUTHORIZATION_FN enables server programs to implement custom RPC authorization techniques.
Syntax
RPC_MGMT_AUTHORIZATION_FN RpcMgmtAuthorizationFn;
int RpcMgmtAuthorizationFn(
RPC_BINDING_HANDLE ClientBinding,
unsigned long RequestedMgmtOperation,
RPC_STATUS *Status
)
{...}
Parameters
ClientBinding
Client/server binding handle.
RequestedMgmtOperation
The value for RequestedMgmtOperation depends on the remote function requested, as shown in the following table.
The authorization function must handle all of these values.
Status
If Status is either 0 (zero) or RPC_S_OK, the Status value RPC_S_ACCESS_DENIED is returned to the client by the remote management function. If the authorization function returns any other value for Status, that Status value is returned to the client by the remote management function.
Return value
Returns TRUE if the calling client is allowed access to the requested management function. If the authorization function returns FALSE, the management function cannot execute. In this case, the function returns a Status value to the client:
Remarks
When a client requests one of the server's remote management functions, the server run-time library calls the authorization function with ClientBinding and RequestedMgmtOperation. The authorization function uses these parameters to determine whether the calling client can execute the requested management function.
Requirements
Requirement | Value |
---|---|
Minimum supported client | Windows 2000 Professional [desktop apps only] |
Minimum supported server | Windows 2000 Server [desktop apps only] |
Target Platform | Windows |
Header | rpcdce.h |