Freigeben über


SspiEncryptAuthIdentityEx-Funktion (sspi.h)

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
);

Die Parameter

[in] Options

Verschlüsselungsoptionen. Dabei kann es sich um einen oder mehrere der folgenden Werte handeln.

Wert Bedeutung
SEC_WINNT_AUTH_IDENTITY_ENCRYPT_SAME_LOGON
Die verschlüsselte Struktur kann nur durch einen 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 im privaten Speicher eines Prozesses für einen längeren Zeitraum beibehalten wird.

[in, out] AuthData

Bei Eingaben zeigt ein Zeiger auf einen Identitätspuffer, der verschlüsselt werden soll. Dieser Puffer muss vor dem Aufruf dieser Funktion für die Verschlüsselung vorbereitet werden. Dies kann durch Aufrufen der Funktion SspiEncryptAuthIdentity erfolgen. Bei der Ausgabe, dem verschlüsselten Identitätspuffer.

Rückgabewert

Wenn die Funktion erfolgreich ist, wird SEC_E_OK zurückgegeben.

Wenn die Funktion fehlschlägt, wird ein Fehlercode ungleich Null zurückgegeben.

Bemerkungen

Um Anmeldeinformationen sicher über Prozesse hinweg zu übertragen, rufen Anwendungen diese Funktion in der Regel mit der Option SEC_WINNT_AUTH_IDENTITY_ENCRYPT_SAME_LOGON gefolgt von SspiMarshalAuthIdentity auf, um einen gemarsteten Authentifizierungspuffer und dessen Länge abzurufen. Der Onlineidentitäts-Anmeldeinformationsanbieter gibt beispielsweise den Authentifizierungspuffer aus der ICredentialProviderCredential::GetSerialization-Methode zurück.

Anforderungen

Anforderung Wert
Mindestens unterstützter Client Windows 8 [nur Desktop-Apps]
Mindestanforderungen für unterstützte Server Windows Server 2012 [nur Desktop-Apps]
Zielplattform Fenster
Header sspi.h
Library mincore.lib