KspVerifySignatureFn-Rückruffunktion (ntsecpkg.h)

Ü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.

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

Weitere Informationen

MakeSignature

SECPKG_USER_FUNCTION_TABLE

SpMakeSignature

SpUserModeInitialize

VerifySignature