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

[アーティクル]
02/23/2024

GetCAPropertyDisplayName メソッドは、証明機関 (CA) プロパティのプロパティ表示名を取得します。

構文

HRESULT GetCAPropertyDisplayName(
  [in]          const BSTR strConfig,
  [in]          LONG       PropId,
  [out, retval] BSTR       *pstrDisplayName
);

パラメーター

[in] strConfig

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

[in] PropId

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

[out, retval] pstrDisplayName

プロパティの表示名を表す BSTR へのポインター。 BSTR の使用が完了したら、SysFreeString 関数を呼び出して解放します。

戻り値

C++

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

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

VB

戻り値は、プロパティの表示名を含む String です。

注釈

GetCAPropertyDisplayName メソッドの機能は、ICertAdmin2::GetCAPropertyDisplayName メソッドの機能と似ています。

ICertAdmin2 メソッドでは、CA は呼び出し元が CA 読み取りアクセス権を持っていることを強制します。これは通常、CA 管理者と CA 管理者にのみ付与されます。

これに対し、メソッドの ICertRequest2 および ICertRequest3 の実装では、CA は既定でアクセス権を必要としません。分散コンポーネントオブジェクトモデル (DCOM) アクセス制御リスト (ACL) のみが適用されます。ドメインに参加している CA の場合、DCOM ACL は CA への Everyone アクセスを許可します。すべてのユーザーに匿名は含まれません。 CA の要求インターフェイスは、レジストリ構成を使用してロックダウンして、呼び出し元が登録アクセス権を持っていることを強制できます。

要件

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