CryptXmlDigestReference 関数 (cryptxml.h)

CryptXmlDigestReference 関数は、解決された参照をダイジェストするためにアプリケーションによって使用されます。 この関数は、ダイジェストを更新する前に変換を適用します。

構文

HRESULT CryptXmlDigestReference(
  [in] HCRYPTXML               hReference,
       DWORD                   dwFlags,
  [in] CRYPT_XML_DATA_PROVIDER *pDataProviderIn
);

パラメーター

[in] hReference

Reference 要素のハンドル。

dwFlags

プロセスが変換を適用する方法を制御する値を指定します。

現在定義されている dwFlags を 次の表に示します。

値	意味
CRYPT_XML_REFERENCE_DATA_TRANSFORMED 0x00000001	変換チェーン エンジンを適用せずに、処理エンジンがダイジェストを作成することを指定します。

[in] pDataProviderIn

データ プロバイダーを指定する CRYPT_XML_DATA_PROVIDER 構造体へのポインター。 CryptXmlDigestReference 関数は、常にデータ プロバイダーで fpnClose 関数を呼び出します。

戻り値

関数が成功した場合、関数は 0 を返します。

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

注釈

CRYPT_XML_REFERENCE_DATA_TRANSFORMED フラグが設定されると、処理エンジンは、変換チェーン エンジンを適用せずに、受信したデータをダイジェストに直接追加します。

メモCryptXmlDigestReference 関数は、常に pDataProviderIn パラメーターによって指されるCRYPT_XML_DATA_PROVIDER構造体の fpnClose メンバーが指す関数を呼び出します。

 

要件

要件	値
サポートされている最小のクライアント	Windows 7 [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows Server 2008 R2 [デスクトップ アプリのみ]
対象プラットフォーム	Windows
ヘッダー	cryptxml.h
Library	Cryptxml.lib
[DLL]	Cryptxml.dll