Função RpcBindingInqAuthInfo (rpcdce.h)
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 .
Valor retornado
| Valor | Significado |
|---|---|
|
A chamada foi bem-sucedida. |
|
O identificador de associação era inválido. |
|
Esse era o tipo errado de associação para a operação. |
|
A associação não tem informações de autenticação. |
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 |