Win32 API 日本語リファレンス
ホーム › Security.Cryptography › CryptXmlDllSignData

CryptXmlDllSignData

コールバック

シグネチャ

HRESULT CryptXmlDllSignData(
    CRYPT_XML_ALGORITHM* pSignatureMethod,
    HCRYPTPROV_OR_NCRYPT_KEY_HANDLE hCryptProvOrNCryptKey,
    DWORD dwKeySpec,
    BYTE* pbInput,
    DWORD cbInput,
    BYTE* pbOutput,
    DWORD cbOutput,
    DWORD* pcbResult
);

パラメーター

フィールド型説明
pSignatureMethodCRYPT_XML_ALGORITHM*アルゴリズムを指定する CRYPT_XML_ALGORITHM 構造体へのポインターです。
hCryptProvOrNCryptKeyHCRYPTPROV_OR_NCRYPT_KEY_HANDLE署名を作成する 暗号化サービスプロバイダー (CSP) のハンドルです。このハンドルは、CryptAcquireContext 関数の呼び出しで取得した HCRYPTPROV ハンドル、または NCryptOpenKey 関数を使用して作成した NCRYPT_KEY_HANDLE ハンドルである必要があります。新しいアプリケーションでは、NCRYPT_KEY_HANDLE ハンドルを渡してください。
dwKeySpecDWORDプロバイダーのコンテナー内で使用する秘密キーです。このキーには AT_KEYEXCHANGE または AT_SIGNATURE を指定できます。hCryptProvOrNCryptKey パラメーターに NCRYPT_KEY_HANDLE ハンドルを使用する場合、このパラメーターは無視されます。
pbInputBYTE*署名するダイジェスト値を格納したバッファーへのポインターです。cbInput パラメーターには、このバッファーのサイズを指定します。
cbInputDWORDpbInput パラメーターが指すバッファーのサイズ (バイト単位) です。
pbOutputBYTE*

この関数が生成した署名を受け取るバッファーのアドレスです。cbOutput パラメーターには、このバッファーのサイズを指定します。

このパラメーターが NULL の場合、この関数は暗号化されたデータに必要なサイズを計算し、そのサイズを pcbResult パラメーターが指す場所に返します。

cbOutputDWORDpbOutput パラメーターが指すバッファーのサイズ (バイト単位) です。
pcbResultDWORD*pbOutput バッファーにコピーされたバイト数を受け取る DWORD 変数へのポインターです。 pbOutput が NULL の場合は、署名に必要なサイズ (バイト単位) を受け取ります。

公式ドキュメント

CryptXmlDllSignData 関数は、データに署名します。

CryptXmlDllSignData 関数は、エクスポートされた CryptXmlDllGetInterface 関数を通じて公開されます。

戻り値

関数が成功した場合、この関数はゼロを返します。

関数が失敗した場合は、エラーを示す HRESULT 値を返します。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)