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.
| Rückgabecode | Beschreibung |
|---|---|
|
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 |