Export (0) Print
Expand All
Expand Minimize

RpcMgmtSetAuthorizationFn function

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

Syntax


RPC_STATUS RPC_ENTRY 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

ValueMeaning
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 functionDefault 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

Minimum supported client

Windows 2000 Professional [desktop apps only]

Minimum supported server

Windows 2000 Server [desktop apps only]

Header

Rpcdce.h (include Rpc.h)

Library

Rpcrt4.lib

DLL

Rpcrt4.dll

See also

RpcMgmtInqStats
RpcMgmtIsServerListening
RpcMgmtStopServerListening
RpcMgmtWaitServerListen
RPC_MGMT_AUTHORIZATION_FN

 

 

Community Additions

ADD
Show:
© 2014 Microsoft