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 |