Função RpcBindingInqAuthInfoExW (rpcdce.h)

Artigo
11/20/2024

A função RpcBindingInqAuthInfoEx retorna informações de autenticação, autorização e qualidade de serviço de segurança de um identificador de associação.

Sintaxe

RPC_STATUS RpcBindingInqAuthInfoExW(
  RPC_BINDING_HANDLE       Binding,
  RPC_WSTR                 *ServerPrincName,
  unsigned long            *AuthnLevel,
  unsigned long            *AuthnSvc,
  RPC_AUTH_IDENTITY_HANDLE *AuthIdentity,
  unsigned long            *AuthzSvc,
  unsigned long            RpcQosVersion,
  RPC_SECURITY_QOS         *SecurityQOS
);

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 RpcBindingInqAuthInfoEx 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. Para obter uma lista dos níveis de autenticação com suporte para RPC, consulte Authentication-Level Constants. 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 RpcBindingSetAuthInfoEx. 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. Para obter uma lista dos serviços de autenticação com suporte para RPC, consulte Authentication-Service Constants.

Especifique um valor nulo para impedir que RpcBindingInqAuthInfoEx 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 RpcBindingInqAuthInfoEx 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. Para obter uma lista dos serviços de autenticação com suporte para RPC, consulte Authentication-Service Constants.

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

RpcQosVersion

Passa o valor da versão atual (necessário para compatibilidade futura se as extensões forem feitas para essa função). Sempre defina esse parâmetro como RPC_C_SECURITY_QOS_VERSION.

SecurityQOS

Retorna o ponteiro para a estrutura de RPC_SECURITY_QOS, que define as configurações de qualidade de serviço.

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 RpcBindingInqAuthInfoEx para exibir as informações de autenticação e autorização associadas a um identificador de associação de servidor. Essa função fornece a capacidade de perguntar sobre a qualidade de serviço de segurança no identificador de associação. De outra forma, é idêntico a RpcBindingInqAuthInfo.

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 RpcBindingInqAuthInfoEx 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

RPC_SECURITY_QOS

RpcBindingSetAuthInfoEx

RpcStringFree

Compartilhar via