Função RpcBindingInqAuthInfoW (rpcdce.h)

Artigo
11/20/2024

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

Sintaxe

RPC_STATUS RpcBindingInqAuthInfoW(
  RPC_BINDING_HANDLE       Binding,
  RPC_WSTR                 *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 de entidade de segurança esperado do servidor referenciado em Binding. 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 Binding. 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 do RPC não dá suporte ao nível de autenticação especificado pelo cliente e atualiza automaticamente para o próximo nível de autenticação mais alto.

AuthnSvc

Retorna um conjunto de ponteiros 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 Binding.

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

AuthzSvc

Retorna um conjunto de ponteiros para o serviço de autorização solicitado pelo aplicativo cliente que fez a chamada de procedimento remoto no Binding See Note.

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

Observação Para obter uma lista dos serviços de autenticação compatíveis com RPC, consulte Authentication-Service Constants.

Valor de retorno

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	Este foi 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.

Observação Para obter uma lista de códigos de erro válidos, consulte RPC Return Values.

Observações

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 fornece informações de qualidade de serviço de segurança no identificador de associação.

A biblioteca de tempo de execução do 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.

Nota

O cabeçalho rpcdce.h define RpcBindingInqAuthInfo como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows 2000 Professional [aplicativos da área de trabalho \| Aplicativos UWP]
servidor com suporte mínimo	Windows 2000 Server [aplicativos da área de trabalho \| Aplicativos UWP]
da Plataforma de Destino	Windows
cabeçalho	rpcdce.h (inclua Rpc.h)
biblioteca	Rpcrt4.lib
de DLL	Rpcrt4.dll

Consulte também

RpcBindingInqAuthClient

RpcBindingInqAuthInfoEx

RpcBindingInqOption

RpcBindingSetAuthInfo

RpcStringFree

Compartilhar via