EncryptMessage （摘要） 函式

EncryptMessage （Digest） 函式會加密訊息以提供隱私權。 EncryptMessage （Digest） 可讓應用程式選擇所選機制所支援 的密碼編譯演算法 。 EncryptMessage （Digest） 函式會使用內容句柄所參考的安全性內容。 某些套件沒有要加密或解密的訊息，而是提供可檢查的完整性 哈希 。

此函式僅供SASL機制使用。

語法

SECURITY_STATUS SEC_ENTRY EncryptMessage(
  PCtxtHandle    phContext,
  unsigned long  fQOP,
  PSecBufferDesc pMessage,
  unsigned long  MessageSeqNo
);

參數

phContext [in]

要用來加密訊息 之安全性內容的 句柄。

fQOP [in]

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

使用摘要 SSP 時，此參數必須設定為零。

pMessage [in， out]

SecBufferDesc 結構的指標。 在輸入時，結構會參考一或多個可SECBUFFER_DATA類型的 SecBuffer 結構。 該緩衝區包含要加密的訊息。 訊息會就地加密，並覆寫結構的原始內容。

函式不會使用 SECBUFFER_READONLY 屬性處理緩衝區。

包含訊息的 SecBuffer 結構的長度不得大於 cbMaximumMessage，這是從 QueryContextAttributes （Digest） （ SECPKG_ATTR_STREAM_SIZES） 函式取得的。

使用摘要式 SSP 時，必須有類型為 SECBUFFER_PADDING 或 SEC_BUFFER_DATA 的第二個緩衝區，才能保存 簽章 資訊。 若要取得輸出緩衝區的大小，請呼叫 QueryContextAttributes （Digest） 函式並指定SECPKG_ATTR_SIZES。 函式會傳回 SecPkgContext_Sizes 結構。 輸出緩衝區的大小是 cbMaxSignature 和 cbBlockSize 成員中值的總和。

不使用 SSL 的應用程式必須提供類型為 SECBUFFER_PADDING 的 SecBuffer 。

MessageSeqNo [in]

傳輸應用程式指派給訊息的序號。 如果傳輸應用程式未維護序號，此參數必須為零。

使用摘要 SSP 時，此參數必須設定為零。 摘要式 SSP 會在內部管理序號。

返回值

如果函式成功，函式會傳回SEC_E_OK。

如果函式失敗，它會傳回下列其中一個錯誤碼。

備註

EncryptMessage （Digest） 函式會根據來自安全性內容的訊息和會話密鑰來加密訊息。

如果傳輸應用程式建立 安全性內容 以支援順序偵測，而呼叫端會提供序號，則函式會包含此資訊與加密的訊息。 包含這項資訊可防止重新執行、插入和隱藏訊息。 安全性套件會納入從傳輸應用程式傳遞的序號。

當您使用摘要 SSP 時，呼叫 QueryContextAttributes （Digest） 函式並指定SECPKG_ATTR_SIZES，以取得輸出緩衝區的大小。 函式會傳回 SecPkgContext_Sizes 結構。 輸出緩衝區的大小是 cbMaxSignature 和 cbBlockSize 成員中值的總和。

為了獲得最佳效能，應該從連續記憶體配置 pMessage 結構。

Windows XP： 此函式也稱為 SealMessage。 應用程式現在應該只使用 EncryptMessage （Digest） 。

需求

另請參閱

SSPI 函式

AcceptSecurityContext （摘要）

DecryptMessage （摘要）

InitializeSecurityContext （摘要）

QueryContextAttributes （摘要）

SecBuffer

SecBufferDesc