SspiEncodeAuthIdentityAsStrings-Funktion (sspi.h)

  • Artikel

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.

Rückgabecode/-wert BESCHREIBUNG
STATUS_INVALID_PARAMETER
0xC000000D
 Das flag SEC_WINNT_AUTH_IDENTITY_FLAGS_PROCESS_ENCRYPTED wird in der Identitätsstruktur festgelegt, die durch den pAuthIdentity-Parameter angegeben wird.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows 7 [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 R2 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile sspi.h
Bibliothek Secur32.lib
DLL SspiCli.dll