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

O RPC_IF_CALLBACK_FN é um protótipo para uma função de retorno de chamada de segurança fornecida pelo aplicativo. Seu programa pode fornecer uma função de retorno de chamada para cada interface definida.

Sintaxe

RPC_IF_CALLBACK_FN RpcIfCallbackFn;

RPC_STATUS RpcIfCallbackFn(
       RPC_IF_HANDLE InterfaceUuid,
  [in] void *Context
)
{...}

Parâmetros

InterfaceUuid

[in] Context

Ponteiro para um identificador de associação de servidor RPC_IF_ID que representa o cliente. Na declaração de função, isso deve ser do tipo RPC_IF_HANDLE, mas é um identificador de associação de cliente e pode ser convertido com segurança nela. A função de retorno de chamada pode passar esse identificador para RpcImpersonateClient, RpcBindingServerFromClient, RpcGetAuthorizationContextForClient ou qualquer outra função do lado do servidor que aceite um identificador de associação de cliente para obter informações sobre o cliente.

Retornar valor

A função de retorno de chamada deverá retornar RPC_S_OK se o cliente tiver permissão para chamar métodos nessa interface. Qualquer outro código de retorno fará com que o cliente receba a exceção RPC_S_ACCESS_DENIED.

Comentários

Em alguns casos, o tempo de execução do RPC pode chamar a função de retorno de chamada de segurança mais de uma vez por cliente por interface. Verifique se a função de retorno de chamada pode lidar com essa possibilidade.

O retorno de chamada de segurança deve ser declarado como RPC_ENTRY.

Requisitos

Confira também

RpcServerRegisterIfEx