Função RpcMgmtSetAuthorizationFn (rpcdce.h)

A função RpcMgmtSetAuthorizationFn estabelece uma função de autorização para processar chamadas remotas para funções de gerenciamento de um servidor.

Sintaxe

RPC_STATUS RpcMgmtSetAuthorizationFn(
  RPC_MGMT_AUTHORIZATION_FN AuthorizationFn
);

Parâmetros

AuthorizationFn

Especifica uma função de autorização. A biblioteca de tempo de execução do servidor RPC chama automaticamente essa função sempre que o tempo de execução do servidor recebe uma solicitação de cliente para executar uma das funções de gerenciamento remoto. O servidor deve implementar essa função. Os aplicativos especificam um valor nulo para cancelar o registro de uma função de autorização registrada anteriormente. Após essa chamada, as autorizações padrão são usadas.

Valor retornado

Valor Significado
RPC_S_OK
A chamada foi bem-sucedida.
 
Nota Para obter uma lista de códigos de erro válidos, consulte RPC Return Values.
 

Comentários

Aplicativos de servidor chamam a função RpcMgmtSetAuthorizationFn para estabelecer uma função de autorização que controla o acesso às funções de gerenciamento remoto do servidor. Quando um servidor não chama RpcMgmtSetAuthorizationFn ou chama com um valor nulo para AuthorizationFn, a biblioteca de tempo de execução do servidor usa as seguintes autorizações padrão.

Função remota Autorização padrão
RpcMgmtInqIfIds habilitado
RpcMgmtInqServerPrincName habilitado
RpcMgmtInqStats habilitado
RpcMgmtIsServerListening habilitado
RpcMgmtStopServerListening Desabilitado
 
 

Na tabela anterior, "Habilitado" indica que todos os clientes podem executar a função remota e "Desabilitado" indica que todos os clientes são impedidos de executar a função remota.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho rpcdce.h (inclua Rpc.h)
Biblioteca Rpcrt4.lib
DLL Rpcrt4.dll

Confira também

RPC_MGMT_AUTHORIZATION_FN

RpcMgmtInqStats

RpcMgmtIsServerListening

RpcMgmtStopServerListening

RpcMgmtWaitServerListen