CertOpenServerOcspResponse 関数 (wincrypt.h)

CertOpenServerOcspResponse 関数は、サーバー証明書チェーンに関連付けられているオンライン証明書状態プロトコル (OCSP) 応答へのハンドルを開きます。

構文

HCERT_SERVER_OCSP_RESPONSE CertOpenServerOcspResponse(
  [in] PCCERT_CHAIN_CONTEXT                 pChainContext,
  [in] DWORD                                dwFlags,
       PCERT_SERVER_OCSP_RESPONSE_OPEN_PARA pOpenPara
);

パラメーター

[in] pChainContext

証明書チェーンを含む CERT_CHAIN_CONTEXT 構造体のアドレス。

[in] dwFlags

pOpenPara

このパラメーターは使用されず、 NULL である必要があります。

戻り値

成功した場合は、サーバー証明書チェーンに関連付けられている OCSP 応答へのハンドルを返します。それ以外の場合は NULL。 このハンドルは、不要になったときに CertCloseServerOcspResponse 関数に渡す必要があります。

拡張エラー情報については、 GetLastError を呼び出します。 GetLastError 関数によって返される可能性のあるエラー コードには、次のものが含まれますが、これらに限定されません。

解説

dwFlags が 0 に設定されている場合、CertOpenServerOcspResponse 関数は、返される前に初期 OCSP 応答の取得を試みます。 取得中にプロセス スレッドがブロックされます。 CertOpenServerOcspResponse 関数は、時間有効な OCSP 応答をプリフェッチするバックグラウンド スレッドを作成します。 最初の OCSP 応答を正常に取得できない場合でも、上記のいずれかのエラーケースがない場合は、NULL 以外のハンドルが返されます。

dwFlags が 1 またはCERT_SERVER_OCSP_RESPONSE_ASYNC_FLAGに設定されている場合、CertOpenServerOcspResponse 関数は、最初の同期取得を行わずに直ちにを返します。

CertOpenServerOcspResponse 関数は、pChainContext パラメーターで表されるチェーン コンテキストの参照カウントをインクリメントします。 チェーン コンテキストの使用が完了したら、 CertCloseServerOcspResponse 関数を呼び出して、返されたハンドルを閉じます。

CertOpenServerOcspResponse 関数は、次の関数で使用される構成設定を初期化します。

• CertAddRefServerOcspResponse
• CertCloseServerOcspResponse
• CertGetServerOcspResponseContext
• CertAddRefServerOcspResponseContext
• CertFreeServerOcspResponseContext

この関数では、次の構成設定名と既定値が初期化されます。

• CERT_SRV_OCSP_RESP_MIN_VALIDITY_SECONDS_VALUE_NAME

  L"SrvOcspRespMinValiditySeconds"

  CertGetServerOcspResponseContext によって返されるサーバー OCSP 応答の最小有効期間。 OCSP 応答の有効性は、クライアントが時間有効として扱うのに十分な長さである必要があります。

• CERT_SRV_OCSP_RESP_MIN_VALIDITY_SECONDS_DEFAULT

  (10 × 60)

  10 分。

• CERT_SRV_OCSP_RESP_URL_RETRIEVAL_TIMEOUT_MILLISECONDS_VALUE_NAME

  L"SrvOcspRespUrlRetrievalTimeoutMilliseconds"

  これは、OCSP 応答プリフェッチ ワイヤ URL 取得がタイムアウトするまでの最大時間です。

• CERT_SRV_OCSP_RESP_URL_RETRIEVAL_TIMEOUT_MILLISECONDS_DEFAULT

  (15 × 1000)

  15 秒。

• CERT_SRV_OCSP_RESP_MAX_BEFORE_NEXT_UPDATE_SECONDS_VALUE_NAME

  L"SrvOcspRespMaxBeforeNextUpdateSeconds"

  これは、OCSP 応答の NextUpdate 日付より前のサーバー OCSP 応答プリフェッチ取得を実行する最大秒数です。 サーバー OCSP 応答スレッドは、現在の時刻が NextUpdate 日付からプリフェッチ取得を実行する秒数を差し引いた値以上になるまで待機します。

• CERT_SRV_OCSP_RESP_MAX_BEFORE_NEXT_UPDATE_SECONDS_DEFAULT

  (4 ×60 × 60)

  4 時間です。

• CERT_SRV_OCSP_RESP_MIN_BEFORE_NEXT_UPDATE_SECONDS_VALUE_NAME

  L"SrvOcspRespMinBeforeNextUpdateSeconds"

  これは、OCSP 応答の NextUpdate 日付より前のサーバー OCSP 応答プリフェッチ取得を実行する最小秒数です。 現在の時刻が NextUpdate 日付からこの秒数を差し引いた値以上の場合、サーバー OCSP 応答スレッドは、NextUpdate 日付に CERT_SRV_OCSP_RESP_MIN_AFTER_NEXT_UPDATE_SECONDS_VALUE_NAME 秒数を加えた後、プリフェッチ取得を実行するまで待機します。

• CERT_SRV_OCSP_RESP_MIN_BEFORE_NEXT_UPDATE_SECONDS_DEFAULT

  (2 × 60)

  2 分。

• CERT_SRV_OCSP_RESP_MIN_AFTER_NEXT_UPDATE_SECONDS_VALUE_NAME

  L"SrvOcspRespMinAfterNextUpdateSeconds"

  これは、OCSP 応答の NextUpdate 日付より後にサーバー OCSP 応答プリフェッチ取得を実行する最小秒数です。 現在の時刻が NextUpdate 日付から CERT_SRV_OCSP_RESP_MIN_BEFORE_NEXT_UPDATE_SECONDS_VALUE_NAME 秒数を引いたが NextUpdate 日付より小さい場合、サーバー OCSP 応答スレッドは、NextUpdate 日付の後にこの秒数を待機してプリフェッチ取得を実行します。

• CERT_SRV_OCSP_RESP_MIN_AFTER_NEXT_UPDATE_SECONDS_DEFAULT

  (1 × 60)

  1 分。

要件

こちらもご覧ください

CertCloseServerOcspResponse