次の方法で共有

ICertAdmin2::GetMyRoles メソッド (certadm.h)

  • [アーティクル]

GetMyRoles メソッドは、呼び出し元の証明機関 (CA) ロールを取得します。

構文

HRESULT GetMyRoles(
  [in]  const BSTR strConfig,
  [out] LONG       *pRoles
);

パラメーター

[in] strConfig

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

重要GetMyRoles は、構成文字列が変更されたときに内部キャッシュをクリアしません。 CA の構成文字列を変更する場合は、新しい ICertAdmin オブジェクトをインスタンス化し、新しい構成文字列を使用してこのメソッドを再度呼び出す必要があります。
 

[out] pRoles

呼び出し元に対して取得された CA ロールを表す LONG 値へのポインター。 これは、次の値の 0 個以上のビットごとの組み合わせにすることができます。

値 意味
CA_ACCESS_ADMIN
0x1
 呼び出し元には CA 管理者機能があります。
CA_ACCESS_AUDITOR
0x4
 呼び出し元には CA 監査機能があります。
CA_ACCESS_ENROLL
0x200
 呼び出し元には登録アクセス権があります。
CA_ACCESS_OFFICER
0x2
 呼び出し元には CA オフィサー機能があります。
CA_ACCESS_OPERATOR
0x8
 呼び出し元には CA バックアップ機能があります。
CA_ACCESS_READ
0x100
 呼び出し元には CA 読み取りアクセス権があります。

戻り値

C++

関数が成功した場合、戻り値はS_OK。

関数が失敗した場合、戻り値はエラーを示す HRESULT です。 一般的なエラー コードの一覧については、「 共通の HRESULT 値」を参照してください。

VB

戻り値は、呼び出し元に対して取得された CA ロールを表す 長整数型 (Long) の値です。 これは、次の値の 0 個以上のビットごとの組み合わせにすることができます。
リターン コード/値 Description
CA_ACCESS_ADMIN
0x1
 呼び出し元には CA 管理者機能があります。
CA_ACCESS_AUDITOR
0x4
 呼び出し元には CA 監査機能があります。
CA_ACCESS_ENROLL
0x200
 呼び出し元には登録アクセス権があります。
CA_ACCESS_OFFICER
0x2
 呼び出し元には CA オフィサー機能があります。
CA_ACCESS_OPERATOR
0x8
 呼び出し元には CA バックアップ機能があります。
CA_ACCESS_READ
0x100
 呼び出し元には読み取りアクセス権があります。

要件

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

関連項目

ICertAdmin2