KspVerifySignatureFn-Rückruffunktion (ntsecpkg.h)

Artikel
02/29/2024

Überprüft, ob die empfangene Nachricht gemäß der Signatur korrekt ist.

Die SpVerifySignature-Funktion ist die Dispatchfunktion für die VerifySignature-Funktion der Schnittstelle des Sicherheitssupportanbieters.

Syntax

KspVerifySignatureFn Kspverifysignaturefn;

NTSTATUS Kspverifysignaturefn(
        LSA_SEC_HANDLE ContextId,
  [in]  PSecBufferDesc Message,
  [in]  ULONG MessageSeqNo,
  [out] PULONG pfQOP
)
{...}

Parameter

ContextId

[in] Message

Zeiger auf eine SecBufferDesc-Struktur , die die zu überprüfende Nachricht enthält.

[in] MessageSeqNo

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] pfQOP

Zeiger auf paketspezifische Flags, die die Qualität des Schutzes angeben.

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. In der folgenden Tabelle sind ein häufiger Fehlergrund und der Fehlercode aufgeführt, den die Funktion zurückgeben soll.

Rückgabecode	Beschreibung
SEC_E_INVALID_HANDLE	Das Handle ist ungültig.

Hinweise

Die von der SpVerifySignature-Funktion überprüfte Signatur wird von der SpMakeSignature-Funktion erstellt, die von einem Nachrichtensender verwendet wird.

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

Ein Zeiger auf die SpVerifySignature-Funktion ist in der SECPKG_USER_FUNCTION_TABLE Struktur verfügbar, die von der SpUserModeInitialize-Funktion 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