IEnumCERTVIEWROW：：EnumCertViewAttribute 方法 (certview.h)

發行項
03/05/2024

EnumCertViewAttribute 方法會取得數據列列舉序列目前數據列的屬性列舉序列實例。

語法

HRESULT EnumCertViewAttribute(
  [in]  LONG                   Flags,
  [out] IEnumCERTVIEWATTRIBUTE **ppenum
);

參數

[in] Flags

C++	LONG 值。必須為零。
VB	Long 值。必須為零。

[out] ppenum

IEnumCERTVIEWATTRIBUTE 類型的指標。成功完成此方法之後， ppenum 會設定為 IEnumCERTVIEWATTRIBUTE 類型的指標。

傳回值

C++

如果方法成功，方法會傳回S_OK。

如果方法失敗，它會傳回 HRESULT 值，指出錯誤。如需常見錯誤碼的清單，請參閱一般 HRESULT 值。

VB

傳回的值是屬性列舉序列物件。

備註

這個呼叫所取得的屬性列舉序列可用來列舉與目前數據列中憑證相關聯的屬性。您可以透過 IEnumCERTVIEWATTRIBUTE 介面的方法來存取此列舉。

若要參考不同的數據列，請呼叫下列其中一個方法來巡覽數據列列舉序列：

IEnumCERTVIEWROW：：Reset：移至列舉序列的開頭。
IEnumCERTVIEWROW：：Next：移至列舉序列中的下一個數據列。
IEnumCERTVIEWROW：：Skip：略過指定的數據列數目。

範例

// pEnumRow is previously instantiated pointer to IEnumCERTVIEWROW
HRESULT                  hr;
LONG                     Index;
IEnumCERTVIEWATTRIBUTE * pEnumAttr = NULL;

// obtain enumerator for attributes
hr = pEnumRow->EnumCertViewAttribute(0, &pEnumAttr);
if (FAILED(hr))
{
    printf("Failed EnumCertViewAttribute - %x\n", hr);
    goto error;
}
// enumerate each attribute
while (S_OK == pEnumAttr->Next(&Index))
{
    // Use this attribute as needed.
}
error:

// Free resources.
if (NULL != pEnumAttr)
    pEnumAttr->Release();

規格需求

需求	值
最低支援的用戶端	都不支援
最低支援的伺服器	Windows Server 2003 [僅限傳統型應用程式]
目標平台	Windows
標頭	certview.h (包含 Certsrv.h)
程式庫	Certidl.lib
Dll	Certadm.dll