SspiEncodeAuthIdentityAsStrings-Funktion (sspi.h)

Codiert die angegebene Authentifizierungsidentität als drei Zeichenfolgen.

Syntax

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

Parameter

[in] pAuthIdentity

Die zu codierende Anmeldeinformationsstruktur.

[out] ppszUserName

Der gemarselte Benutzername der Identität, die durch den pAuthIdentity-Parameter angegeben wird.

Wenn Sie die Verwendung dieser Zeichenfolge abgeschlossen haben, geben Sie sie frei, indem Sie die SspiFreeAuthIdentity-Funktion aufrufen.

[out] ppszDomainName

Der Gemarstdomänenname der Identität, die durch den pAuthIdentity-Parameter angegeben wird.

Wenn Sie die Verwendung dieser Zeichenfolge abgeschlossen haben, geben Sie sie frei, indem Sie die SspiFreeAuthIdentity-Funktion aufrufen.

[out] ppszPackedCredentialsString

Eine codierte Zeichenfolgenversion einer SEC_WINNT_AUTH_IDENTITY_EX2-Struktur , die die Benutzeranmeldeinformationen angibt.

Wenn Sie die Verwendung dieser Zeichenfolge abgeschlossen haben, geben Sie sie frei, indem Sie die SspiFreeAuthIdentity-Funktion aufrufen.

Rückgabewert

Wenn die Funktion erfolgreich ist, gibt sie SEC_E_OK zurück.

Wenn die Funktion fehlschlägt, gibt sie einen fehlerfreien Fehlercode zurück. Mögliches Werte (aber nicht die Einzigen) sind die in der folgenden Tabelle.

Anforderungen