Função QueryContextAttributesExA (sspi.h)
Permite que um aplicativo de transporte consulte um pacote de segurança para determinados atributos de um contexto de segurança.
Sintaxe
SECURITY_STATUS SEC_ENTRY QueryContextAttributesExA(
[in] PCtxtHandle phContext,
[in] unsigned long ulAttribute,
[out] void *pBuffer,
[in] unsigned long cbBuffer
);
Parâmetros
[in] phContext
Um identificador para o contexto de segurança a ser consultado.
[in] ulAttribute
Especifica o atributo do contexto a ser retornado. Esse parâmetro pode usar um dos valores a seguir.
| Valor | Significado |
|---|---|
|
O parâmetro pBuffer contém um ponteiro para uma estrutura SecPkgContext_AccessToken .
Retorna um identificador para o token de acesso. |
|
O parâmetro pBuffer contém um ponteiro para uma estrutura de SecPkgContext_SessionAppData .
Retorna ou especifica os dados do aplicativo para a sessão. Esse atributo só tem suporte no pacote de segurança do Schannel. |
|
O parâmetro pBuffer contém um ponteiro para uma estrutura SecPkgContext_Authority .
Consulta o nome da autoridade de autenticação. |
|
O parâmetro pBuffer contém um ponteiro para uma estrutura SecPkgContext_ClientSpecifiedTarget que representa o SPN ( nome da entidade de serviço ) do destino inicial fornecido pelo cliente.
Windows Server 2008, Windows Vista, Windows Server 2003 e Windows XP: Não há suporte para esse valor. |
|
O parâmetro pBuffer contém um ponteiro para uma estrutura SecPkgContext_ConnectionInfo .
Retorna informações detalhadas sobre a conexão estabelecida. Esse atributo só tem suporte no pacote de segurança do Schannel. |
|
O parâmetro pBuffer contém um ponteiro para uma estrutura de SecPkgContext_ClientCreds que especifica as credenciais do cliente.
Se a credencial do cliente for nome de usuário e senha, o buffer será uma estrutura de KERB_INTERACTIVE_LOGON empacotada. Se a credencial do cliente for o nome de usuário e o PIN de cartão inteligente, o buffer será uma estrutura de KERB_CERTIFICATE_LOGON empacotada. Se a credencial do cliente for uma credencial de identidade online, o buffer será uma estrutura de SEC_WINNT_AUTH_IDENTITY_EX2 marshaled. Esse atributo só tem suporte no servidor CredSSP. Windows Server 2008 R2, Windows 7, Windows Server 2008, Windows Vista, Windows Server 2003 e Windows XP: Não há suporte para esse valor. |
|
O parâmetro pBuffer contém um ponteiro para uma estrutura SecPkgContext_DceInfo .
Consultas para dados de autorização usados pelos serviços de DCE. |
|
O parâmetro pBuffer contém um ponteiro para uma estrutura de SecPkgContext_Bindings que especifica informações de associação de canal.
Esse atributo só tem suporte no pacote de segurança do Schannel. Windows Server 2008, Windows Vista, Windows Server 2003 e Windows XP: Não há suporte para esse valor. |
|
O parâmetro pBuffer contém um ponteiro para uma estrutura SecPkgContext_EapKeyBlock .
Consultas para dados de chave usados pelo protocolo TLS EAP. Esse atributo só tem suporte no pacote de segurança do Schannel. |
|
O parâmetro pBuffer contém um ponteiro para uma estrutura SecPkgContext_Flags .
Retorna informações sobre os sinalizadores de contexto negociados. |
|
O parâmetro pBuffer contém um ponteiro para uma estrutura SecPkgContext_IssuerListInfoEx .
Retorna uma lista de emissores de certificado que são aceitos pelo servidor. Esse atributo só tem suporte no pacote de segurança do Schannel. |
|
O parâmetro pBuffer contém um ponteiro para uma estrutura de SecPkgContext_KeyInfo .
Consulta informações sobre as chaves usadas em um contexto de segurança. |
|
O parâmetro pBuffer contém um ponteiro para uma estrutura SecPkgContext_LastClientTokenStatus que especifica se o token da chamada mais recente para a função InitializeSecurityContext é o último token do cliente.
Esse valor só tem suporte nos pacotes de segurança Negotiate, Kerberos e NTLM. Windows Server 2008, Windows Vista, Windows Server 2003 e Windows XP: Não há suporte para esse valor. |
|
O parâmetro pBuffer contém um ponteiro para uma estrutura SecPkgContext_Lifespan .
Consulta a duração do contexto. |
|
O parâmetro pBuffer contém um ponteiro para uma estrutura de PCCERT_CONTEXT .
Localiza um contexto de certificado que contém um certificado final local. Esse atributo só tem suporte no pacote de segurança do Schannel. |
|
O parâmetro pBuffer contém um ponteiro para uma estrutura de SecPkgContext_LocalCredentialInfo . (obsoleto) Substituído por SECPKG_ATTR_LOCAL_CERT_CONTEXT. |
|
O parâmetro pBuffer contém um ponteiro para uma estrutura de SecPkgContext_Names .
Consulta o nome associado ao contexto. |
|
O parâmetro pBuffer contém um ponteiro para uma estrutura de SecPkgContext_NativeNames .
Retorna o CNAME (nome principal) do tíquete de saída. |
|
O parâmetro pBuffer contém um ponteiro para uma estrutura SecPkgContext_NegotiationInfo .
Retorna informações sobre o pacote de segurança a ser usado com o processo de negociação e o estado atual da negociação para o uso desse pacote. |
|
O parâmetro pBuffer contém um ponteiro para uma estrutura de SecPkgContext_PackageInfo .
Retorna informações sobre o SSP em uso. |
|
O parâmetro pBuffer contém um ponteiro para uma estrutura SecPkgContext_PasswordExpiry .
Retorna informações de expiração de senha. |
|
O parâmetro pBuffer contém um ponteiro para uma estrutura de PCCERT_CONTEXT .
Localiza um contexto de certificado que contém o certificado final fornecido pelo servidor. Esse atributo só tem suporte no pacote de segurança do Schannel. |
|
O parâmetro pBuffer contém um ponteiro para um HCERTCONTEXT. Localiza um contexto de certificado que contém um certificado fornecido pelo repositório Raiz. |
|
O parâmetro pBuffer contém um ponteiro para uma estrutura de SecPkgContext_SessionKey .
Retorna informações sobre as chaves de sessão. |
|
O parâmetro pBuffer contém um ponteiro para uma estrutura de SecPkgContext_SessionInfo .
Retorna informações sobre a sessão. Windows Server 2008, Windows Vista, Windows Server 2003 e Windows XP: Não há suporte para esse valor. Esse atributo só tem suporte no pacote de segurança do Schannel. |
|
O parâmetro pBuffer contém um ponteiro para uma estrutura SecPkgContext_Sizes .
Consulta os tamanhos das estruturas usadas nas funções por mensagem. |
|
O parâmetro pBuffer contém um ponteiro para uma estrutura SecPkgContext_StreamSizes .
Consulta os tamanhos das várias partes de um fluxo usado nas funções por mensagem. Esse atributo só tem suporte no pacote de segurança do Schannel. |
|
O parâmetro pBuffer contém um ponteiro para uma estrutura SecPkgContext_SubjectAttributes .
Esse valor retorna informações sobre os atributos de segurança para a conexão. Esse valor tem suporte apenas no servidor CredSSP. Windows Server 2008, Windows Vista, Windows Server 2003 e Windows XP: Não há suporte para esse valor. |
|
O parâmetro pBuffer contém um ponteiro para uma estrutura SecPkgContext_SupportedSignatures .
Esse valor retorna informações sobre os tipos de assinatura com suporte para a conexão. Esse valor só tem suporte no pacote de segurança do Schannel. Windows Server 2008, Windows Vista, Windows Server 2003 e Windows XP: Não há suporte para esse valor. |
|
O parâmetro pBuffer contém um ponteiro para uma estrutura SecPkgContext_TargetInformation .
Retorna informações sobre o nome do servidor remoto. |
|
O parâmetro pBuffer contém um ponteiro para uma estrutura de SecPkgContext_Bindings que especifica informações de associação de canal.
Esse valor só tem suporte no pacote de segurança do Schannel. Windows Server 2008, Windows Vista, Windows Server 2003 e Windows XP: Não há suporte para esse valor. |
[out] pBuffer
Um ponteiro para uma estrutura que recebe os atributos. O tipo de estrutura apontada depende do valor especificado no parâmetro ulAttribute .
[in] cbBuffer
O tamanho, em bytes, do parâmetro pBuffer .
Retornar valor
Se a função for bem-sucedida, o valor retornado será SEC_E_OK.
Se a função falhar, o valor retornado será um código de erro diferente de zero.
Comentários
Observação
O cabeçalho sspi.h define QueryContextAttributesEx como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows XP [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows Server 2003 [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | sspi.h (inclua Security.h) |
| Biblioteca | Secur32.lib |
| DLL | Secur32.dll |
Confira também
Comentários
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulte https://aka.ms/ContentUserFeedback.
Enviar e exibir comentários de