Partager via

SspiEncodeAuthIdentityAsStrings, fonction (sspi.h)

  • Article

Encode l’identité d’authentification spécifiée sous la forme de trois chaînes.

Syntaxe

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

Paramètres

[in] pAuthIdentity

Structure des informations d’identification à encoder.

[out] ppszUserName

Nom d’utilisateur marshalé de l’identité spécifiée par le paramètre pAuthIdentity .

Lorsque vous avez terminé d’utiliser cette chaîne, libérez-la en appelant la fonction SspiFreeAuthIdentity .

[out] ppszDomainName

Nom de domaine marshalé de l’identité spécifiée par le paramètre pAuthIdentity .

Lorsque vous avez terminé d’utiliser cette chaîne, libérez-la en appelant la fonction SspiFreeAuthIdentity .

[out] ppszPackedCredentialsString

Version de chaîne encodée d’une structure de SEC_WINNT_AUTH_IDENTITY_EX2 qui spécifie les informations d’identification des utilisateurs.

Lorsque vous avez terminé d’utiliser cette chaîne, libérez-la en appelant la fonction SspiFreeAuthIdentity .

Valeur retournée

Si la fonction réussit, elle retourne SEC_E_OK.

Si la fonction échoue, elle retourne un code d’erreur différent de zéro. Les valeurs possibles sont notamment celles figurant dans le tableau suivant.

Code/valeur de retour Description
STATUS_INVALID_PARAMETER
0xC000000D
 L’indicateur SEC_WINNT_AUTH_IDENTITY_FLAGS_PROCESS_ENCRYPTED est défini dans la structure d’identité spécifiée par le paramètre pAuthIdentity.

Configuration requise

   
Client minimal pris en charge Windows 7 [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2008 R2 [applications de bureau uniquement]
Plateforme cible Windows
En-tête sspi.h
Bibliothèque Secur32.lib
DLL SspiCli.dll