ICEnroll::enumContainers メソッド (xenroll.h)
[このメソッドは、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 |