ICEnroll：：enumContainers 方法 (xenroll.h)
[此方法已不再可供 Windows Server 2008 和 Windows Vista 使用。]
enumContainers 方法會擷取 ProviderName 屬性所指定之密碼編譯服務提供者 (CSP) 的容器名稱。 這個方法最初是在 ICEnroll 介面中定義。
語法
HRESULT enumContainers(
[in] LONG dwIndex,
[out] BSTR *pbstr
);
參數
[in] dwIndex
指定將擷取其名稱之容器的序數位置。 為第一個容器指定零。
[out] pbstr
接收容器名稱的 BSTR 變數指標。 當您完成 使用 BSTR 時，請藉由呼叫 SysFreeString 函式 來釋放它。
傳回值
C++
傳回值為 HRESULT。 值S_OK表示成功。 沒有其他專案時，會傳回值ERROR_NO_MORE_ITEMS。VB
傳回值是 String 變數，代表容器的名稱。 如果發生錯誤，或沒有其他專案時，就會引發例外狀況。備註
如果未設定 ProviderName 屬性值，則會使用在登錄中所設定的 ProviderName) ， (預設值。
當憑證註冊控件以腳本控件的形式執行時，就會停用這個方法。
範例
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 |
| 程式庫 | Uuid.lib |
| Dll | Xenroll.dll |