Função RpcBindingInqAuthInfo (rpcdce.h)

  • Artigo

A função RpcBindingInqAuthInfo retorna informações de autenticação e autorização de um identificador de associação.

Sintaxe

RPC_STATUS RpcBindingInqAuthInfo(
  RPC_BINDING_HANDLE       Binding,
  RPC_CSTR                 *ServerPrincName,
  unsigned long            *AuthnLevel,
  unsigned long            *AuthnSvc,
  RPC_AUTH_IDENTITY_HANDLE *AuthIdentity,
  unsigned long            *AuthzSvc
);

Parâmetros

Binding

Identificador de associação de servidor do qual as informações de autenticação e autorização são retornadas.

ServerPrincName

Retorna um ponteiro para um ponteiro para o nome principal esperado do servidor referenciado em Associação. O conteúdo do nome retornado e sua sintaxe são definidos pelo serviço de autenticação em uso.

Especifique um valor nulo para impedir que RpcBindingInqAuthInfo retorne o parâmetro ServerPrincName . Nesse caso, o aplicativo não chama a função RpcStringFree .

AuthnLevel

Retorna um ponteiro definido para o nível de autenticação usado para chamadas de procedimento remoto feitas usando Associação. Consulte a observação.

Especifique um valor nulo para impedir que a função retorne o parâmetro AuthnLevel .

O nível retornado no parâmetro AuthnLevel pode ser diferente do nível especificado quando o cliente chamou a função RpcBindingSetAuthInfo . Essa discrepância ocorre quando a biblioteca de tempo de execução RPC não dá suporte ao nível de autenticação especificado pelo cliente e é atualizada automaticamente para o próximo nível de autenticação mais alto.

AuthnSvc

Retorna um ponteiro definido para o serviço de autenticação especificado para chamadas de procedimento remoto feitas usando Binding. Consulte a observação.

Especifique um valor nulo para impedir que RpcBindingInqAuthInfo retorne o parâmetro AuthnSvc .

AuthIdentity

Retorna um ponteiro para um identificador para a estrutura de dados que contém as credenciais de autenticação e autorização do cliente especificadas para chamadas de procedimento remoto feitas usando Associação.

Especifique um valor nulo para impedir que RpcBindingInqAuthInfo retorne o parâmetro AuthIdentity .

AuthzSvc

Retorna um ponteiro definido para o serviço de autorização solicitado pelo aplicativo cliente que fez a chamada de procedimento remoto em Associação Consulte Observação.

Especifique um valor nulo para impedir que RpcBindingInqAuthInfo retorne o parâmetro AuthzSvc .

Nota Para obter uma lista dos serviços de autenticação com suporte para RPC, consulte Authentication-Service Constants.
 

Valor retornado

Valor Significado
RPC_S_OK
 A chamada foi bem-sucedida.
RPC_S_INVALID_BINDING
 O identificador de associação era inválido.
RPC_S_WRONG_KIND_OF_BINDING
 Esse era o tipo errado de associação para a operação.
RPC_BINDING_HAS_NO_AUTH
 A associação não tem informações de autenticação.
 
Nota Para obter uma lista de códigos de erro válidos, consulte RPC Return Values.
 

Comentários

Um aplicativo cliente chama a função RpcBindingInqAuthInfo para exibir as informações de autenticação e autorização associadas a um identificador de associação de servidor. Uma função semelhante, RpcBindingInqAuthInfoEx , também fornece informações de qualidade de serviço de segurança no identificador de associação.

A biblioteca de tempo de execução RPC aloca memória para o parâmetro ServerPrincName retornado. O aplicativo é responsável por chamar a função RpcStringFree para essa cadeia de caracteres de argumento retornada.

Requisitos

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

Confira também

RpcBindingInqAuthClient

RpcBindingInqAuthInfoEx

RpcBindingInqOption

RpcBindingSetAuthInfo

RpcStringFree