CryptGetObjectUrl 関数 (wincrypt.h)

CryptGetObjectUrl 関数は、証明書、証明書信頼リスト (CTL)、または証明書失効リスト (CRL) からリモート オブジェクトの URL を取得します。

関数は オブジェクトを受け取り、デコードし、オブジェクトから URL の配列へのポインターを提供します。 たとえば、証明書からは、URL の CRL 配布リストが配列内にあります。

構文

BOOL CryptGetObjectUrl(
  [in]      LPCSTR           pszUrlOid,
  [in]      LPVOID           pvPara,
  [in]      DWORD            dwFlags,
  [out]     PCRYPT_URL_ARRAY pUrlArray,
  [in, out] DWORD            *pcbUrlArray,
  [out]     PCRYPT_URL_INFO  pUrlInfo,
  [in, out] DWORD            *pcbUrlInfo,
            LPVOID           pvReserved
);

パラメーター

[in] pszUrlOid

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

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

[in] pvPara

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

[in] dwFlags

オブジェクトの URL ロケーターを取得するために使用されるフラグのセット。 これは、0 または次の値の 1 つ以上の組み合わせにすることができます。

[out] pUrlArray

値エントリのデータを受信するバッファーへのポインター。 データを保持するために必要なバッファーの長さを検索するには、このパラメーターに NULL を 指定できます。

詳細については、「不明な 長さのデータの取得」を参照してください。

[in, out] pcbUrlArray

pUrlArray パラメーターが指すバッファーのサイズをバイト単位で指定する DWORD へのポインター。 関数が戻るときに、 DWORD にはバッファーに格納されているバイト数が含まれます。 このパラメーターは、pUrlArray が NULL の場合にのみ NULL にすることができます。

[out] pUrlInfo

値エントリのデータを受け取る CRYPT_URL_INFO 構造体への省略可能なポインター。

[in, out] pcbUrlInfo

pUrlArray パラメーターが指すバッファーのサイズをバイト単位で指定する DWORD へのポインター。 関数が戻るときに、 DWORD にはバッファーに格納されているバイト数が含まれます。

pvReserved

将来使用するために予約されており、 NULL である必要があります。

戻り値

関数が成功した場合、関数は 0 以外 (TRUE) を返します。

関数が失敗した場合は、0 (FALSE) を返します。 拡張エラー情報については、 GetLastError を呼び出します。

要件

関連項目

リモート オブジェクト取得関数