Share via

Função SspiEncodeAuthIdentityAsStrings (sspi.h)

  • Artigo

Codifica a identidade de autenticação especificada como três cadeias de caracteres.

Sintaxe

SECURITY_STATUS SEC_ENTRY SspiEncodeAuthIdentityAsStrings(
  [in]  PSEC_WINNT_AUTH_IDENTITY_OPAQUE pAuthIdentity,
  [out] PCWSTR                          *ppszUserName,
  [out] PCWSTR                          *ppszDomainName,
  [out] PCWSTR                          *ppszPackedCredentialsString
);

Parâmetros

[in] pAuthIdentity

A estrutura de credenciais a ser codificada.

[out] ppszUserName

O nome de usuário marshaled da identidade especificada pelo parâmetro pAuthIdentity .

Quando terminar de usar essa cadeia de caracteres, libere-a chamando a função SspiFreeAuthIdentity .

[out] ppszDomainName

O nome de domínio marshaled da identidade especificada pelo parâmetro pAuthIdentity .

Quando terminar de usar essa cadeia de caracteres, libere-a chamando a função SspiFreeAuthIdentity .

[out] ppszPackedCredentialsString

Uma versão de cadeia de caracteres codificada de uma estrutura de SEC_WINNT_AUTH_IDENTITY_EX2 que especifica as credenciais dos usuários.

Quando terminar de usar essa cadeia de caracteres, libere-a chamando a função SspiFreeAuthIdentity .

Valor retornado

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. Os possíveis valores incluem, mas sem limitação, aqueles na tabela a seguir.

Valor/código retornado Descrição
STATUS_INVALID_PARAMETER
0xC000000D
 O sinalizador SEC_WINNT_AUTH_IDENTITY_FLAGS_PROCESS_ENCRYPTED é definido na estrutura de identidade especificada pelo parâmetro pAuthIdentity .

Requisitos

   
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 Secur32.lib
DLL SspiCli.dll