ICertServerPolicy::EnumerateAttributes 方法 (certif.h)
EnumerateAttributes 方法會擷取目前屬性的名稱,並將內部列舉指標移至下一個屬性。
語法
HRESULT EnumerateAttributes(
[out] BSTR *pstrAttributeName
);
參數
[out] pstrAttributeName
屬性名稱的指標。
傳回值
C++
如果方法成功,方法會傳回S_OK,而 pstrAttributeName 參數會設定為包含屬性名稱的 BSTR 。 如果已列舉最後一個屬性,則會傳回值S_FALSE。若要使用此方法,請建立 BSTR 類型的變數、將變數設定為 NULL,然後將此變數的位址傳遞為 pstrAttributeName。
當您完成 使用 BSTR 時,請藉由呼叫 SysFreeString 函式 來釋放它。
如果方法失敗,它會傳回 HRESULT 值,指出錯誤。 如需常見錯誤碼的清單,請參閱 一般 HRESULT 值。
VB
傳回包含屬性名稱的字串,如果已經列舉最後一個屬性,則傳回空字串。備註
第一次呼叫 EnumerateAttributes 方法之前,請先呼叫 EnumerateAttributesSetup 方法,以初始化第一個屬性的列舉指標。
完成列舉時,呼叫
EnumerateAttributesClose 方法,可釋放列舉呼叫所使用的資源。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | 都不支援 |
最低支援的伺服器 | Windows Server 2003 [僅限傳統型應用程式] |
目標平台 | Windows |
標頭 | certif.h (包括 Certsrv.h) |
程式庫 | Certidl.lib |
Dll | Certcli.dll |