SslEncryptPacket 函式

SslEncryptPacket函式會加密單一安全通訊端層通訊協定， (SSL) 封包。

語法

SECURITY_STATUS WINAPI SslEncryptPacket(
  _In_    NCRYPT_PROV_HANDLE hSslProvider,
  _Inout_ NCRYPT_KEY_HANDLE  hKey,
  _In_    PBYTE              *pbInput,
  _In_    DWORD              cbInput,
  _Out_   PBYTE              pbOutput,
  _In_    DWORD              cbOutput,
  _Out_   DWORD              *pcbResult,
  _In_    ULONGLONG          SequenceNumber,
  _In_    DWORD              dwContentType,
  _In_    DWORD              dwFlags
);

參數

hSslProvider [in]

SSL 通訊協定提供者實例的控制碼。

hKey [in， out]

用來加密封包之金鑰的控制碼。

pbInput [in]

緩衝區的指標，其中包含要加密的封包。

cbInput [in]

pbInput緩衝區的長度，以位元組為單位。

pbOutput [out]

要接收加密封包之緩衝區的指標。

cbOutput [in]

pbOutput緩衝區的長度、位元組。

azureResult [out]

寫入 pbOutput 緩衝區的位元組數目。

SequenceNumber [in]

對應至這個封包的序號。

dwContentType [in]

對應至此封包的內容類型，指定用來處理封包的高階通訊協定。

值	意義
CT_CHANGE_CIPHER_SPEC 20	指出加密策略中的變更。
CT_ALERT 21	表示封入封包包含警示。
CT_HANDSHAKE 22	表示封包是交握通訊協定的一部分。
CT_APPLICATIONDATA 23	表示封包包含應用程式資料。

dwFlags [in]

這個參數保留給未來使用。

傳回值

如果函式成功，則會傳回零。

如果函式失敗，它會傳回非零錯誤值。

可能的傳回碼包括但不限於下列各項。

傳回碼/值	Description
NTE_INVALID_HANDLE 0x80090026L	其中一個提供的控制碼無效。

規格需求

需求	值
最低支援的用戶端	Windows Vista [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2008 [僅限傳統型應用程式]
標頭	Sslprovider.h
DLL	Ncrypt.dll