SpUnsealMessageFn-Rückruffunktion (ntsecpkg.h)

Entschlüsselt eine Nachricht, die zuvor mit der SpSealMessage-Funktion verschlüsselt wurde.

Die SpUnsealMessage-Funktion ist die Verteilerfunktion für die DecryptMessage -Funktion (Allgemein) der Schnittstelle des Sicherheitsunterstützungsanbieters.

Syntax

SpUnsealMessageFn Spunsealmessagefn;

NTSTATUS Spunsealmessagefn(
  [in]  LSA_SEC_HANDLE ContextHandle,
  [in]  PSecBufferDesc MessageBuffers,
  [in]  ULONG MessageSequenceNumber,
  [out] PULONG QualityOfProtection
)
{...}

Parameter

[in] ContextHandle

Handle des Sicherheitskontexts , der zum Versiegeln der Nachricht verwendet wird.

[in] MessageBuffers

Zeiger auf eine SecBufferDesc-Struktur , die die Nachrichtenpuffer und einen Signaturpuffer enthält.

[in] MessageSequenceNumber

Sequenznummer, die der Nachricht zugewiesen werden soll. Sequenznummern sind optional und werden als Schutz vor Verlust und Einfügen von Nachrichten verwendet. Der Wert 0 gibt an, dass Sequenznummern nicht verwendet werden.

[out] QualityOfProtection

Wird nicht verwendet.

Rückgabewert

Wenn die Funktion erfolgreich ist, geben Sie STATUS_SUCCESS zurück.

Wenn die Funktion fehlschlägt, geben Sie einen NTSTATUS-Code zurück, der den Grund für einen Fehler angibt.

Hinweise

SSP/APs müssen die SpUnsealMessage-Funktion implementieren. Der tatsächliche Name, der der Implementierung zugewiesen wird, liegt jedoch beim Entwickler.

Ein Zeiger auf die SpUnsealMessage-Funktion ist in der SECPKG_USER_FUNCTION_TABLE Struktur verfügbar, die von der Funktion SpUserModeInitialize empfangen wird.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	ntsecpkg.h

Weitere Informationen

DecryptMessage (Allgemein)

SECPKG_USER_FUNCTION_TABLE

SpSealMessage

SpUserModeInitialize