Função SspiGetCredUIContext (sspi.h)

  • Artigo

Recupera informações de contexto de um provedor de credenciais.

Sintaxe

SECURITY_STATUS SEC_ENTRY SspiGetCredUIContext(
  [in]  HANDLE                           ContextHandle,
  [in]  GUID                             *CredType,
  [in]  LUID                             *LogonId,
  [out] PSEC_WINNT_CREDUI_CONTEXT_VECTOR *CredUIContexts,
  [out] HANDLE                           *TokenHandle
);

Parâmetros

[in] ContextHandle

Um ponteiro para uma estrutura SEC_WINNT_CREDUI_CONTEXT recuperada durante uma chamada anterior para a função SspiUnmarshalCredUIContext .

[in] CredType

O tipo de credencial especificado pelo parâmetro ContextHandle . Esse pode ser um dos valores a seguir.

Valor Significado
SEC_WINNT_AUTH_DATA_TYPE_PASSWORD
0x28bfc32f, 0x10f6, 0x4738, 0x98, 0xd1, 0x1a, 0xc0, 0x61, 0xdf, 0x71, 0x6a
 A credencial é uma senha.
SEC_WINNT_AUTH_DATA_TYPE_CERT
0x235f69ad, 0x73fb, 0x4dbc, 0x82, 0x3, 0x6, 0x29, 0xe7, 0x39, 0x33, 0x9b
 A credencial é um certificado.
SEC_WINNT_AUTH_DATA_TYPE_CSP_DATA
0x68fd9879, 0x79c, 0x4dfe, 0x82, 0x81, 0x57, 0x8a, 0xad, 0xc1, 0xc1, 0x0
 A credencial são dados de autenticação de um provedor de serviços criptográficos (CSP).

[in] LogonId

A ID de logon associada à credencial especificada pelo parâmetro ContextHandle .

O chamador deve estar em execução como LocalSystem para especificar uma ID de logon.

[out] CredUIContexts

Um ponteiro para uma estrutura SEC_WINNT_CREDUI_CONTEXT_VECTOR que especifica o deslocamento e o tamanho dos dados na estrutura especificada pelo parâmetro ContextHandle .

[out] TokenHandle

Um identificador para o token do usuário especificado.

Retornar valor

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

Se a função falhar, ela retornará um código de erro diferente de zero.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 7 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 R2 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho sspi.h
Biblioteca Credui.lib
DLL Credui.dll