SspiEncryptAuthIdentityEx-Funktion (sspi.h)

Artikel
08/26/2023

Verschlüsselt eine SEC_WINNT_AUTH_IDENTITY_OPAQUE-Struktur .

Syntax

SECURITY_STATUS SEC_ENTRY SspiEncryptAuthIdentityEx(
  [in]      ULONG                           Options,
  [in, out] PSEC_WINNT_AUTH_IDENTITY_OPAQUE AuthData
);

Parameter

[in] Options

Verschlüsselungsoptionen. Dies kann mindestens einer der folgenden Werte sein.

Wert	Bedeutung
SEC_WINNT_AUTH_IDENTITY_ENCRYPT_SAME_LOGON	Die verschlüsselte Struktur kann nur von einem Sicherheitskontext in derselben Anmeldesitzung entschlüsselt werden. Diese Option wird verwendet, um einen Identitätspuffer zu schützen, der über einen lokalen RPC gesendet wird.
SEC_WINNT_AUTH_IDENTITY_ENCRYPT_SAME_PROCESS	Die verschlüsselte Struktur kann nur durch denselben Prozess entschlüsselt werden. Das Aufrufen der Funktion mit dieser Option entspricht dem Aufrufen von SspiEncryptAuthIdentity. Diese Option wird verwendet, um einen Identitätspuffer zu schützen, der über einen längeren Zeitraum im privaten Arbeitsspeicher eines Prozesses gespeichert wird.

[in, out] AuthData

Bei der Eingabe ein Zeiger auf einen zu verschlüsselnden Identitätspuffer. Dieser Puffer muss vor dem Aufruf dieser Funktion für die Verschlüsselung vorbereitet sein. Dazu rufen Sie die Funktion SspiEncryptAuthIdentity auf. Bei der Ausgabe der verschlüsselte Identitätspuffer.

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.

Hinweise

Um Anmeldeinformationen prozessübergreifend sicher zu übertragen, rufen Anwendungen diese Funktion in der Regel mit der Option SEC_WINNT_AUTH_IDENTITY_ENCRYPT_SAME_LOGON auf, gefolgt von SspiMarshalAuthIdentity , um einen gemarselten Authentifizierungspuffer und dessen Länge zu erhalten. Der Onlineidentitätsanbieter tut dies beispielsweise, um den Authentifizierungspuffer von seiner ICredentialProviderCredential::GetSerialization-Methode zurückzugeben.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 8 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2012 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	sspi.h

Freigeben über