ICertRequest2::GetCAProperty メソッド (certcli.h)

GetCAProperty メソッドは、証明機関 (CA) のプロパティ値を取得します。 このメソッドの機能は、 ICertAdmin2::GetCAProperty と同じです。 このメソッドの詳細については、「 ICertAdmin2::GetCAProperty」を参照してください。

構文

HRESULT GetCAProperty(
  [in]          const BSTR strConfig,
  [in]          LONG       PropId,
  [in]          LONG       PropIndex,
  [in]          LONG       PropType,
  [in]          LONG       Flags,
  [out, retval] VARIANT    *pvarPropertyValue
);

パラメーター

[in] strConfig

COMPUTERNAME\CANAME 形式の CA の有効な構成文字列を表します。COMPUTERNAME は証明書サービス サーバーのネットワーク名、CANAME は証明書サービスのセットアップ時に入力された CA の共通名です。 構成文字列名の詳細については、「 ICertConfig」を参照してください。

[in] PropId

プロパティ識別子を指定します。 このパラメーターの詳細については、 ICertAdmin2::GetCAProperty の表を参照してください。

[in] PropIndex

PropId にインデックスが付いている場合、プロパティ値を取得するときに使用する 0 から始まるインデックス。 PropId がインデックス付けされていない場合、この値は無視されます。

[in] PropType

プロパティの型を指定します。これは、 PropId テーブルの Type 列に対応します。 型には、次のいずれかの型を指定できます。

意味
PROPTYPE_LONG
署名された長いデータ
PROPTYPE_DATE
日付/時刻 (将来の使用のために予約)
PROPTYPE_BINARY
Binary Data
PROPTYPE_STRING
Unicode 文字列データ

[in] Flags

次のフラグを使用して、返されるプロパティ値の形式を指定できます。これらのフラグはバイナリ データ (証明書、証明書チェーン、証明書 失効リストなど) に対してのみ意味を持ち、それ以外の場合は無視されます。

意味
CV_OUT_BASE64
BEGIN/END なしの BASE64
CV_OUT_BASE64HEADER
BASE64 と BEGIN CERTIFICATE と END CERTIFICATE
CV_OUT_BASE64REQUESTHEADER
BASE64 で新しい証明書要求を開始し、新しい証明書要求を終了する
CV_OUT_BASE64X509CRLHEADER
BASE64 と BEGIN X509 CRL と END X509 CRL
CV_OUT_BINARY
Binary
CV_OUT_HEX
16 進数文字列
CV_OUT_HEXADDR
アドレス/オフセットを含む 16 進文字列
CV_OUT_HEXASCII
ASCII を含む 16 進数の文字列
CV_OUT_HEXASCIIADDR
ASCII とアドレス/オフセットを含む 16 進文字列

[out, retval] pvarPropertyValue

要求されたプロパティ値を受け取る VARIANT へのポインター。

VARIANT の使用が完了したら、VariantClear 関数を呼び出して解放します。

戻り値

C++

メソッドが成功した場合、メソッドは S_OKを返します。

メソッドが失敗した場合は、エラーを示す HRESULT 値を返します。 一般的なエラー コードの一覧については、「 共通 HRESULT 値」を参照してください。

VB

戻り値は、要求されたプロパティ値を受け取る バリアント型 (Variant) の 値です。

要件

要件
サポートされている最小のクライアント サポートなし
サポートされている最小のサーバー Windows Server 2003 (デスクトップ アプリのみ)
対象プラットフォーム Windows
ヘッダー certcli.h (Certsrv.h を含む)
Library Certidl.lib
[DLL] Certcli.dll

こちらもご覧ください

CCertRequest

ICertRequest

ICertRequest2