CryptGetTimeValidObject 関数 (wincrypt.h)

CryptGetTimeValidObject 関数は、特定のコンテキストと時間内に有効な CRL、OCSP 応答、または CTL オブジェクトを取得します。

構文

BOOL CryptGetTimeValidObject(
  [in]                LPCSTR                                  pszTimeValidOid,
  [in]                LPVOID                                  pvPara,
  [in]                PCCERT_CONTEXT                          pIssuer,
  [in, optional]      LPFILETIME                              pftValidFor,
  [in]                DWORD                                   dwFlags,
  [in]                DWORD                                   dwTimeout,
  [out, optional]     LPVOID                                  *ppvObject,
  [in, optional]      PCRYPT_CREDENTIALS                      pCredentials,
  [in, out, optional] PCRYPT_GET_TIME_VALID_OBJECT_EXTRA_INFO pExtraInfo
);

パラメーター

[in] pszTimeValidOid

要求されているオブジェクトを識別するオブジェクト 識別子 (OID) へのポインター。 pszTimeValidOid パラメーターの HIWORD が 0 の場合、LOWORD は指定した構造体の型の整数識別子を指定します。

このパラメーターには、次の値のいずれかを指定できます。 これらの値が pvPara パラメーターにどのように影響するかについては、「意味」列の「pvPara パラメーターの場合」という見出しを参照してください。

[in] pvPara

pszTimeValidOid の値によって決定される構造体。 詳細については、 pszTimeValidOid パラメーターの説明を参照してください。

[in] pIssuer

発行者の証明書を含む CERT_CONTEXT へのポインター。

[in, optional] pftValidFor

現在のシステム時刻のオプションの FILETIME 構造体バージョンまたは現在のコンテキストからの更新時刻へのポインター。

[in] dwFlags

タイムアウト、ソース、有効性チェックなど、さまざまな取得要因を決定する値。

次の表に、 dwFlags パラメーターに使用できる値を示します。

[in] dwTimeout

結果を返していない URL 取得試行を終了するタイミングを指定する値 (ミリ秒単位)。

[out, optional] ppvObject

返されるオブジェクトのアドレスへのポインター。 戻り値の型には、CryptRetrieveObjectByUrl 関数の pszObjectOid パラメーターに示されているサポートされている型のいずれかを指定できます。

[in, optional] pCredentials

URL へのアクセスに使用される省略可能な CRYPT_CREDENTIALS 構造体へのポインター。 現在サポートされている資格情報の種類は、ユーザー名とパスワードの資格情報のみです。

[in, out, optional] pExtraInfo

オブジェクトのキャッシュ エントリに関する追加情報を含む省略可能な CRYPT_GET_TIME_VALID_OBJECT_EXTRA_INFO 構造体へのポインター。

戻り値

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

関数が失敗すると、 FALSE が返されます。 拡張エラー情報については、 GetLastError を呼び出します。

考えられるエラー コードの一部を次に示します。

注釈

Cryptnet ダイナミック リンク ライブラリは、 CryptGetTimeValidObject 関数をサポートするために使用される時間有効なオブジェクト (TVO) キャッシュを実装します。 キャッシュは、各キャッシュ エントリが次の情報で構成されるプロセス グローバル TVO エージェントによって使用されます。

• 配信元識別子
• コンテキスト OID
• Context
• 取得 URL
• 有効期限
• オフライン URL 時刻情報

要件