SslSignHash 函式

SslSignHash函式會使用指定的私密金鑰簽署雜湊。 簽署程式會在伺服器上執行。

語法

SECURITY_STATUS WINAPI SslSignHash(
  _In_  NCRYPT_PROV_HANDLE hSslProvider,
  _In_  NCRYPT_KEY_HANDLE  hPrivateKey,
  _In_  PBYTE              pbHashValue,
  _In_  DWORD              cbHashValue,
  _Out_ PBYTE              pbSignature,
  _In_  DWORD              cbSignature,
  _Out_ DWORD              *pcbResult,
  _In_  DWORD              dwFlags
);

參數

hSslProvider [in]

安全通訊端層通訊協定的控制碼 (SSL) 通訊協定提供者實例。

hPrivateKey [in]

用來簽署雜湊之私密金鑰的控制碼。

pbHashValue [in]

緩衝區的指標，其中包含要簽署的雜湊。

cbHashValue [in]

pbHashValue緩衝區的大小，以位元組為單位。

pbSignature [out]

接收雜湊簽章的緩衝區位址。 cbSignature參數包含這個緩衝區的大小。 若要判斷緩衝區所需的大小，請將 pbSignature 參數設定為 Null。 緩衝區的必要大小將會在 azureResult 參數中傳回。

cbSignature [in]

pbSignature緩衝區的大小，以位元組為單位。

azureResult [out]

完成時，值的指標包含寫入 pbSignature 緩衝區的實際位元組數目。

dwFlags [in]

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

傳回值

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

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

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

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

規格需求

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