Função QueryContextAttributes (CredSSP)

A função QueryContextAttributes (CredSSP) permite que um aplicativo de transporte consulte o pacote de segurança CredSSP (Credential Security Support Provider) para determinados atributos de um contexto de segurança.

Sintaxe

SECURITY_STATUS SEC_ENTRY QueryContextAttributes(
  _In_  PCtxtHandle phContext,
  _In_  ULONG       ulAttribute,
  _Out_ PVOID       pBuffer
);

Parâmetros

phContext [em]

Um identificador para o contexto de segurança a ser consultado.

ulAttribute [em]

O atributo do contexto a ser retornado. Este parâmetro pode ser um dos seguintes valores. A menos que especificado de outra forma, os atributos são aplicáveis ao cliente e ao servidor.

Valor	Significado
SECPKG_ATTR_C_ACCESS_TOKEN 0x80000012	O parâmetro pBuffer contém um ponteiro para uma estrutura SecPkgContext_AccessToken que especifica o token de acesso para o contexto de segurança atual. Este atributo é suportado apenas no servidor.
SECPKG_ATTR_C_FULL_ACCESS_TOKEN 0x80000082	O parâmetro pBuffer contém um ponteiro para uma estrutura SecPkgContext_AccessToken que especifica o token de acesso para o contexto de segurança atual. Este atributo é suportado apenas no servidor.
SECPKG_ATTR_CERT_TRUST_STATUS 0x80000084	O parâmetro pBuffer contém um ponteiro para uma estrutura CERT_TRUST_STATUS que especifica informações de confiança sobre o certificado. Este atributo é suportado apenas no cliente.
SECPKG_ATTR_CREDS 0x80000080	O parâmetro pBuffer contém um ponteiro para uma estrutura de SecPkgContext_ClientCreds que especifica as credenciais do cliente. As credenciais do cliente podem ser nome de usuário e senha ou nome de usuário e PIN de cartão inteligente. Este atributo é suportado apenas no servidor.
SECPKG_ATTR_CREDS_2 0x80000086	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 compactada. Se a credencial do cliente for nome de usuário e PIN de cartão inteligente, o buffer será uma estrutura de KERB_CERTIFICATE_LOGON compactada. Se a credencial do cliente for uma credencial de identidade online, o buffer será uma estrutura de SEC_WINNT_AUTH_IDENTITY_EX2 empacotada. Este atributo é suportado apenas no servidor CredSSP. Windows Server 2008 R2, Windows 7, Windows Server 2008, Windows Vista, Windows Server 2003 e Windows XP: Este valor não é suportado.
SECPKG_ATTR_NEGOTIATION_PACKAGE 0x80000081	O parâmetro pBuffer contém um ponteiro para uma estrutura SecPkgContext_PackageInfo que especifica o nome do pacote de autenticação negociado pelo provedor Microsoft Negotiate .
SECPKG_ATTR_PACKAGE_INFO 10	O parâmetro pBuffer contém um ponteiro para uma estrutura SecPkgContext_PackageInfo. Retorna informações sobre o SSP em uso.
SECPKG_ATTR_SERVER_AUTH_FLAGS 0x80000083	O parâmetro pBuffer contém um ponteiro para uma estrutura SecPkgContext_Flags que especifica informações sobre os sinalizadores no contexto de segurança atual. Este atributo é suportado apenas no cliente.
SECPKG_ATTR_SIZES 0x0	O parâmetro pBuffer contém um ponteiro para uma estrutura SecPkgContext_Sizes . Consulta os tamanhos das estruturas usadas nas funções por mensagem e trocas de autenticação.
SECPKG_ATTR_SUBJECT_SECURITY_ATTRIBUTES 124	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 é suportado somente no servidor CredSSP. Windows Server 2008, Windows Vista, Windows Server 2003 e Windows XP: Este valor não é suportado.

 

pBuffer [saída]

Um ponteiro para uma estrutura que recebe os atributos. O tipo de estrutura depende do valor do parâmetro ulAttribute .

Valor de retorno

Se a função for bem-sucedida, ela retornará SEC_E_OK.

Se a função falhar, ele pode retornar os seguintes códigos de erro.

Observações

A estrutura apontada pelo parâmetro pBuffer varia dependendo do atributo que está sendo consultado.

Enquanto o chamador deve alocar a própria estrutura pBuffer , o SSP aloca qualquer memória necessária para armazenar membros de tamanho variável da estrutura pBuffer . A memória alocada pelo SSP deve ser liberada chamando a função FreeContextBuffer .

Requerimentos

Ver também

Funções SSPI

CERT_CONTEXT

FreeContextBuffer

SecPkgContext_ClientCreds

SecPkgContext_Sizes