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.
| Rückgabecode/-wert | BESCHREIBUNG |
|---|---|
|
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 |