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

A função RPC_AUTH_KEY_RETRIEVAL_FN é um protótipo para uma função que especifica o endereço de uma rotina fornecida pelo aplicativo de servidor que retorna chaves de criptografia.

Sintaxe

RPC_AUTH_KEY_RETRIEVAL_FN RpcAuthKeyRetrievalFn;

void RpcAuthKeyRetrievalFn(
  void *Arg,
  RPC_WSTR ServerPrincName,
  unsigned long KeyVer,
  void **Key,
  RPC_STATUS *Status
)
{...}

Parâmetros

Arg

Ponteiro para um argumento definido pelo usuário para a função de aquisição de chave de criptografia fornecida pelo usuário. A biblioteca de tempo de execução RPC usa o parâmetro Arg fornecido para RpcServerRegisterAuthInfo.

ServerPrincName

Ponteiro para o nome principal a ser usado para o servidor ao autenticar chamadas de procedimento remoto. A biblioteca de tempo de execução RPC usa o parâmetro ServerPrincName fornecido a RpcServerRegisterAuthInfo.

KeyVer

Valor que a biblioteca de tempo de execução RPC fornece automaticamente para o parâmetro key-version. Quando o valor for zero, a função de aquisição deverá retornar a chave mais recente disponível.

Key

Ponteiro para um ponteiro para a chave de autenticação retornada pela função fornecida pelo usuário.

Status

Ponteiro para o status retornado pela função de aquisição quando é chamado pela biblioteca de tempo de execução RPC para autenticar a solicitação RPC do cliente. Se o status não for RPC_S_OK, a solicitação falhará e a biblioteca em tempo de execução retornará o erro status ao aplicativo cliente.

Retornar valor

Nenhum

Comentários

Uma função de recuperação de chave de autorização especifica o endereço de uma rotina fornecida pelo servidor-aplicativo que retorna chaves de criptografia.

Requisitos

Confira também

RpcServerRegisterAuthInfo