PFN_CRYPT_XML_DATA_PROVIDER_READ コールバック関数 (cryptxml.h)

PFN_CRYPT_XML_DATA_PROVIDER_READコールバック関数は XML データを読み取ります。

構文

PFN_CRYPT_XML_DATA_PROVIDER_READ PfnCryptXmlDataProviderRead;

HRESULT PfnCryptXmlDataProviderRead(
  [in, out] void *pvCallbackState,
  [out]     BYTE *pbData,
  [in]      ULONG cbData,
  [out]     ULONG *pcbRead
)
{...}

パラメーター

[in, out] pvCallbackState

呼び出し元の関数に渡されるアプリケーション定義引数へのポインター。

[out] pbData

読み取るデータを受け取るバッファーへのポインター。

[in] cbData

読み取るデータのサイズ (バイト単位)。

[out] pcbRead

実際に読み取られたバイト数を受け取る変数へのポインター。

戻り値

PFN_CRYPT_XML_DATA_PROVIDER_READコールバック関数は、次のいずれかの条件が発生したときに値を返します。

• データ プロバイダーで書き込み操作が完了する
• 要求されたバイト数が読み取られます
• エラーが発生する

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

pcbRead の値が 0 の場合、使用できるデータはこれ以上ありません。

注釈

cbData で指定されたバイト数が使用可能であるか、データの最後のブロックが読み取られた場合を除き、コールバック関数は値を返しません。

要件