RpcMgmtSetAuthorizationFn function (rpcdce.h)

The RpcMgmtSetAuthorizationFn function establishes an authorization function for processing remote calls to a server's management functions.

Syntax

RPC_STATUS RpcMgmtSetAuthorizationFn(
  RPC_MGMT_AUTHORIZATION_FN AuthorizationFn
);

Parameters

AuthorizationFn

Specifies an authorization function. The RPC server run-time library automatically calls this function whenever the server run-time receives a client request to execute one of the remote management functions. The server must implement this function. Applications specify a value of NULL to unregister a previously registered authorization function. After such a call, default authorizations are used.

Return value

Remarks

Server applications call the RpcMgmtSetAuthorizationFn function to establish an authorization function that controls access to the server's remote management functions. When a server has not called RpcMgmtSetAuthorizationFn, or calls with a null value for AuthorizationFn, the server run-time library uses the following default authorizations.

In the preceding table, "Enabled" indicates that all clients can execute the remote function, and "Disabled" indicates that all clients are prevented from executing the remote function.

Requirements

See also

RPC_MGMT_AUTHORIZATION_FN

RpcMgmtInqStats

RpcMgmtIsServerListening

RpcMgmtStopServerListening

RpcMgmtWaitServerListen