共用方式為

spSealMessageFn 回呼函式 (ntsecpkg.h)

  • 發行項

加密客戶端與伺服器之間交換的訊息。

SpSealMessage 函式是 Security Support Provider Interface 之 EncryptMessage (General) 函式的分派函式。

語法

SpSealMessageFn Spsealmessagefn;

NTSTATUS Spsealmessagefn(
  [in]      LSA_SEC_HANDLE ContextHandle,
  [in]      ULONG QualityOfProtection,
  [in, out] PSecBufferDesc MessageBuffers,
  [in]      ULONG MessageSequenceNumber
)
{...}

參數

[in] ContextHandle

用來簽署訊息 的安全性內容 句柄。

[in] QualityOfProtection

指定指出保護品質的套件特定旗標。 SSP/AP 可以使用此參數來啟用密碼編譯演算法的選取。

[in, out] MessageBuffers

包含訊息緩衝區 的 SecBufferDesc 結構的指標。 只有其中一個訊息緩衝區的類型可以是 SECBUFFER_DATA，而且它包含要加密的訊息。 緩衝區不能有 SECBUFFER_READONLY 屬性，因為加密已就地完成。

[in] MessageSequenceNumber

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

傳回值

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

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

傳回碼 Description
STATUS_INVALID_HANDLE
 找不到內容或未設定訊息完整性。
STATUS_INVALID_PARAMETER
 找不到簽章緩衝區或太小。

備註

使用 SpSealMessage 函式由傳送者加密的郵件會使用 SpUnsealMessage 函式解密。

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

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

規格需求

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

另請參閱

SECPKG_USER_FUNCTION_TABLE

SpUnsealMessage

SpUserModeInitialize