função de retorno de chamada RPC_MGMT_AUTHORIZATION_FN (rpcdce.h)

O RPC_MGMT_AUTHORIZATION_FN permite que os programas de servidor implementem técnicas de autorização RPC personalizadas.

Sintaxe

RPC_MGMT_AUTHORIZATION_FN RpcMgmtAuthorizationFn;

int RpcMgmtAuthorizationFn(
  RPC_BINDING_HANDLE ClientBinding,
  unsigned long RequestedMgmtOperation,
  RPC_STATUS *Status
)
{...}

Parâmetros

ClientBinding

Identificador de associação cliente/servidor.

RequestedMgmtOperation

O valor de RequestedMgmtOperation depende da função remota solicitada, conforme mostrado na tabela a seguir.

Função remota chamada Significado
RpcMgmtInqIfIds
RPC_C_MGMT_INQ_IF_IDS
RpcMgmtInqServerPrincName
RPC_C_MGMT_INQ_PRINC_NAME
RpcMgmtInqStats
RPC_C_MGMT_INQ_STATS
RpcMgmtIsServerListening
RPC_C_MGMT_IS_SERVER_LISTEN
RpcMgmtStopServerListening
RPC_C_MGMT_STOP_SERVER_LISTEN
 

A função de autorização deve lidar com todos esses valores.

Status

Se Status for 0 (zero) ou RPC_S_OK, o valor status RPC_S_ACCESS_DENIED será retornado ao cliente pela função de gerenciamento remoto. Se a função de autorização retornar qualquer outro valor para Status, esse valor status será retornado ao cliente pela função de gerenciamento remoto.

Retornar valor

Retornará TRUE se o cliente de chamada tiver permissão para acessar a função de gerenciamento solicitada. Se a função de autorização retornar FALSE, a função de gerenciamento não poderá ser executada. Nesse caso, a função retorna um valor status para o cliente:

Comentários

Quando um cliente solicita uma das funções de gerenciamento remoto do servidor, a biblioteca em tempo de execução do servidor chama a função de autorização com ClientBinding e RequestedMgmtOperation. A função de autorização usa esses parâmetros para determinar se o cliente de chamada pode executar a função de gerenciamento solicitada.

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

Confira também

Funções de autorização

RpcMgmtSetAuthorizationFn