CRYPT_RETRIEVE_AUX_INFO構造体 (wincrypt.h)

  • [アーティクル]

CRYPT_RETRIEVE_AUX_INFO構造体には、CryptRetrieveObjectByUrl 関数に渡す省略可能な情報が含まれています。 この構造体の未使用のメンバーには、すべて 0 を含める必要があります。

構文

typedef struct _CRYPT_RETRIEVE_AUX_INFO {
  DWORD                              cbSize;
  FILETIME                           *pLastSyncTime;
  DWORD                              dwMaxUrlRetrievalByteCount;
  PCRYPTNET_URL_CACHE_PRE_FETCH_INFO pPreFetchInfo;
  PCRYPTNET_URL_CACHE_FLUSH_INFO     pFlushInfo;
  PCRYPTNET_URL_CACHE_RESPONSE_INFO  *ppResponseInfo;
  LPWSTR                             pwszCacheFileNamePrefix;
  LPFILETIME                         pftCacheResync;
  BOOL                               fProxyCacheRetrieval;
  DWORD                              dwHttpStatusCode;
  LPWSTR                             *ppwszErrorResponseHeaders;
  PCRYPT_DATA_BLOB                   *ppErrorContentBlob;
} CRYPT_RETRIEVE_AUX_INFO, *PCRYPT_RETRIEVE_AUX_INFO;

メンバー

cbSize

構造体のサイズ (バイト単位)。

pLastSyncTime

取得したデータの最後の同期時刻を含む FILETIME 構造体。

dwMaxUrlRetrievalByteCount

取得したバイト数の制限を指定する 値。 0 以下の値は、制限を指定しません。

pPreFetchInfo

CRYPTNET_URL_CACHE_PRE_FETCH_INFO構造体へのポインター。 プリフェッチ情報を取得するには、入力時にその cbSize を 設定します。 cbSize を除くプリフェッチ情報がない場合、戻り時にデータ構造に 0 が含まれます。

pFlushInfo

CRYPTNET_URL_CACHE_FLUSH_INFO構造体へのポインター。 フラッシュ情報を取得するには、入力時にその cbSize を 設定します。 cbSize を除くフラッシュ情報がない場合、データ構造は戻り時にゼロを含みます。

ppResponseInfo

PCRYPTNET_URL_CACHE_RESPONSE_INFO構造体へのポインター。 応答情報を取得するには、割り当てられた構造体で更新 されたCRYPTNET_URL_CACHE_RESPONSE_INFO ポインターのアドレスにポインターを設定します。 応答情報がない場合、 ppResponseInfo は NULL に設定されます。 NULL でない場合は、CryptMemFree 関数を使用して解放する必要があります。

pwszCacheFileNamePrefix

キャッシュされたファイル名のプレフィックスを含む文字列へのポインター。 NULL でない場合、指定したプレフィックス文字列はキャッシュされたファイル名の先頭に連結されます。

pftCacheResync

キャッシュ同期時間を指定する FILETIME 構造体へのポインター。 NULL でない場合、この時刻より前にキャッシュされた情報は無効と見なされます。 CRYPT_CACHE_ONLY_RETRIEVALの場合、この時点より前にキャッシュされたエントリがある場合、CryptRetrieveObjectByUrl はERROR_INVALID_TIMEを返します。 HTTP 取得で使用する場合、これは時間有効なオブジェクトの最大有効期間を指定します。

fProxyCacheRetrieval

CryptRetrieveObjectByUrl が dwRetrievalFlags で設定されたCRYPT_PROXY_CACHE_RETRIEVALで呼び出され、プロキシ キャッシュが取得のために明示的にバイパスされなかったかどうかを示す値。 このフラグは明示的にクリアされず、HTTP URL の取得にのみ適用されます。

dwHttpStatusCode

失敗した HTTP 応答ヘッダーの状態コードを示す 値。 CRYPT_NOT_MODIFIED_RETRIEVALが dwRetrievalFlags で設定され、HTTP 取得によってHTTP_STATUS_NOT_MODIFIEDが返された場合、これにはHTTP_STATUS_NOT_MODIFIED状態コードが含まれます。 この値は明示的にクリアされず、HTTP または HTTPS URL の取得に対してのみ更新されます。

ppwszErrorResponseHeaders

ppErrorContentBlob

要件

要件 値
サポートされている最小のクライアント Windows XP (デスクトップ アプリのみ)
サポートされている最小のサーバー Windows Server 2003 (デスクトップ アプリのみ)
Header wincrypt.h