KspVerifySignatureFn 回呼函式 (ntsecpkg.h)

  • 發行項

根據 簽章驗證收到的訊息是否正確。

SpVerifySignature 函式是安全性支援提供者介面之 VerifySignature 函式的分派函式。

語法

KspVerifySignatureFn Kspverifysignaturefn;

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

參數

ContextId

[in] Message

包含要驗證之訊息的 SecBufferDesc 結構的指標。

[in] MessageSeqNo

要指派給訊息的序號。 序號是選擇性的，可用來防止訊息遺失和插入。 值為零表示序號不在使用中。

[out] pfQOP

指出保護品質之套件特定旗標的指標。

傳回值

如果函式成功，則傳回STATUS_SUCCESS。

如果函式失敗，則傳回 NTSTATUS 程式代碼，指出失敗的原因。 下表列出失敗的常見原因，以及函式應該傳回的錯誤碼。

傳回碼 Description
SEC_E_INVALID_HANDLE
 句柄無效。

備註

SpVerifySignature 函式所驗證的簽章是由訊息傳送者所使用的 SpMakeSignature 函式所建立。

SSP/AP 必須實作 SpVerifySignature 函式 ;不過，提供給實作的實際名稱會由開發人員決定。

SpVerifySignature 函式的指標可在從 SpUserModeInitialize 函式收到的SECPKG_USER_FUNCTION_TABLE結構中使用。

規格需求

需求 值
最低支援的用戶端 Windows XP [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2003 [僅限傳統型應用程式]
目標平台 Windows
標頭 ntsecpkg.h

另請參閱

MakeSignature

SECPKG_USER_FUNCTION_TABLE

SpMakeSignature

SpUserModeInitialize

VerifySignature