ICEnroll::enumContainers メソッド (xenroll.h)

[アーティクル]
08/28/2023

[このメソッドは、Windows Server 2008 および Windows Vista では使用できなくなりました。

enumContainers メソッドは、ProviderName プロパティで指定された暗号化サービスプロバイダー (CSP) のコンテナーの名前を取得します。このメソッドは、 ICEnroll インターフェイスで最初に定義されました。

構文

HRESULT enumContainers(
  [in]  LONG dwIndex,
  [out] BSTR *pbstr
);

パラメーター

[in] dwIndex

名前を取得するコンテナーの序数位置を指定します。最初のコンテナーに 0 を指定します。

[out] pbstr

コンテナーの名前を受け取る BSTR 変数へのポインター。 BSTR の使用が完了したら、SysFreeString 関数を呼び出して解放します。

戻り値

C++

戻り値は HRESULT です。 S_OK の値は成功を示します。 ERROR_NO_MORE_ITEMS値は、項目がなくなったときに返されます。

VB

戻り値は、コンテナーの名前を表す String 変数です。エラーが発生した場合、または項目がなくなった場合は、例外が発生します。

注釈

ProviderName プロパティの値が設定されていない場合は、レジストリに設定されている ProviderName の既定値 (通常は Microsoft Base Cryptographic Provider) が使用されます。

このメソッドは、証明書登録コントロールがスクリプト化されたコントロールとして実行されるときに無効になります。

例

BSTR       bstrCon = NULL;
DWORD      nCon = 0;
HRESULT    hr;

// pEnroll is previously instantiated ICEnroll interface pointer
while ( S_OK == pEnroll->enumContainers(nCon, &bstrCon) )
{
    printf("\t%d) %ws\n", nCon++, bstrCon );
    if ( bstrCon )
    {
        SysFreeString( bstrCon );
        bstrCon = NULL;
    }
}

要件

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