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]

Secure Sockets Layer プロトコル (SSL) プロトコル プロバイダー インスタンスへのハンドル。

hPrivateKey [in]

ハッシュの署名に使用する秘密キーへのハンドル。

pbHashValue [in]

署名するハッシュを含むバッファーへのポインター。

cbHashValue [in]

pbHashValue バッファーのサイズ (バイト単位)。

pbSignature [out]

ハッシュの署名を受け取るバッファーのアドレス。 cbSignature パラメーターには、このバッファーのサイズが含まれています。 バッファーの必要なサイズを決定するには、 pbSignature パラメーターを NULL に設定 します。 バッファーの必要なサイズは 、pcbResult パラメーターで返されます。

cbSignature [in]

pbSignature バッファーのサイズ (バイト単位)。

pcbResult [out]

完了時に pbSignature バッファーに書き込まれた実際のバイト数を含む値へのポインター。

dwFlags [in]

このパラメーターは将来使用するために予約されています。

戻り値

関数が成功すると、0 が返されます。

関数が失敗すると、0 以外のエラー値が返されます。

可能なリターン コードには、次のものが含まれますが、これらに限定されません。

リターン コード/値	説明
NTE_INVALID_HANDLE 0x80090026L	指定されたハンドルの 1 つが無効です。

要件

要件	値
サポートされている最小のクライアント	Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows Server 2008 [デスクトップ アプリのみ]
Header	Sslprovider.h
[DLL]	Ncrypt.dll