RpcMgmtSetAuthorizationFn function (rpcdce.h)

Article
02/22/2024

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

Value	Meaning
RPC_S_OK	The call succeeded.

Note For a list of valid error codes, see RPC Return Values.

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.

Remote function	Default authorization
RpcMgmtInqIfIds	Enabled
RpcMgmtInqServerPrincName	Enabled
RpcMgmtInqStats	Enabled
RpcMgmtIsServerListening	Enabled
RpcMgmtStopServerListening	Disabled

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

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 (include Rpc.h)
Library	Rpcrt4.lib
DLL	Rpcrt4.dll