KspMakeSignatureFn 回呼函式 (ntsecpkg.h)

  • 發行項

SpMakeSignature 函式會根據指定的訊息和安全性內容產生簽章。

SpMakeSignature 函式是安全性支援提供者介面的MakeSignature函式分派函式。

語法

KspMakeSignatureFn Kspmakesignaturefn;

NTSTATUS Kspmakesignaturefn(
  [in] LSA_SEC_HANDLE ContextId,
  [in] ULONG fQOP,
  [in] PSecBufferDesc Message,
  [in] ULONG MessageSeqNo
)
{...}

參數

[in] ContextId

要用來產生訊息簽章之安全性內容的句柄。

[in] fQOP

指定指出保護品質的套件特定旗標。 安全性套件可以使用此參數來支持選取密碼編譯演算法

[in] Message

SecBuffer 結構的指標。 在輸入時，結構會包含要簽署的訊息。

[in] MessageSeqNo

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

傳回值

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

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

傳回碼 Description
SEC_E_INVALID_HANDLE
 句柄無效。

備註

SpMakeSignature 函式的對應專案是 SpVerifySignature 函式，用來驗證接收端的簽章。

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

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

規格需求

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

另請參閱

MakeSignature

SECPKG_USER_FUNCTION_TABLE

SpUserModeInitialize

SpVerifySignature