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
| Value | Meaning |
|---|---|
|
The call succeeded. |
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 |