ICEnroll::p ut_RootStoreName メソッド (xenroll.h)

  • [アーティクル]

[このプロパティは、Windows Server 2008 および Windows Vista では使用できなくなりました。

RootStoreName プロパティは、本質的に信頼された自己署名ルート証明書がすべて保持されているルート ストアの名前を設定または取得します。

このプロパティの既定値は "ROOT" です。 ルート ストアに関連付けられている信頼レベルのため、ユーザーは (ユーザー インターフェイスを使用して) 証明書を受け入れるように求められる場合があります。 このプロパティは多くのアプリケーションで変更する必要はありませんが、 ルート証明書の信頼に関連付けられているユーザー インターフェイスを回避するために、 RootStoreName を "CA" に設定する可能性があります。

このプロパティは、 ICEnroll インターフェイスで最初に定義されました。

このプロパティは読み取り/書き込み可能です。

構文

HRESULT put_RootStoreName(
  BSTR bstrName
);

パラメーター

bstrName

戻り値

なし

解説

RootStoreName は 、次のメソッドの動作に影響します。

このプロパティを設定する機能は、証明書登録コントロールがスクリプト化されたコントロールとして実行されるときに無効になります。

例

BSTR     bstrStoreName = NULL;
HRESULT  hr;

// pEnroll is previously instantiated ICEnroll interface pointer

// get the storename
hr = pEnroll->get_RootStoreName( &bstrStoreName );
if ( FAILED ( hr ) )
    printf("Failed getting RootStoreName - %x\n", hr );
else
    printf( "RootStoreName: %ws\n", bstrStoreName );
// free BSTR when done
if ( NULL != bstrStoreName )
    SysFreeString( bstrStoreName );

// set the storename
// bstrNewName is a BSTR that is previously set to a valid store name
hr = pEnroll->put_RootStoreName( bstrNewName );
if ( FAILED ( hr ) )
    printf("Failed setting RootStoreName - %x\n", hr );
else
    printf( "RootStoreName was set to : %ws\n", bstrNewName );

要件

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