ICertRequest2::GetCAPropertyDisplayName メソッド (certcli.h)
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 |