IEnumCERTVIEWATTRIBUTE：：Next 方法 (certview.h)

發行項
02/26/2024

Next 方法會移至屬性列舉序列中的下一個屬性。

語法

HRESULT Next(
  [out] LONG *pIndex
);

參數

[out] pIndex

變數的指標，其中包含所參考之下一個屬性的索引值。如果沒有其他要列舉的屬性，此變數會設定為 –1。如果 pIndex 為 NULL，這個方法就會失敗。

傳回值

C++

如果方法成功，方法會傳回S_OK，而下一個屬性現在正由屬性列舉序列參考。如果沒有其他屬性，方法會傳回S_FALSE，而 pIndex 會設定為 –1 的值。

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

VB

傳回值是屬性的索引值，現在由屬性列舉序列參考。如果沒有更多要列舉的屬性，傳回值為 –1。

備註

成功完成此方法之後，可以透過下列方法來存取屬性名稱和值：

範例

LONG       Index;
HRESULT    hr;
BSTR       bstrAttribName = NULL;

// pEnumAttr is previously instantiated IEnumCERTVIEWATTRIBUTE object
while (S_OK == pEnumAttr->Next(&Index))
{
    // retrieve the attribute name
    hr = pEnumAttr->GetName(&bstrAttribName);
    if (FAILED(hr))
        printf("Failed GetName -  %x\n", hr );
    else
        printf("Attribute name: %ws\n", bstrAttribName);
}

// Free resources.
if (NULL != bstrAttribName)
    SysFreeString(bstrAttribName);

規格需求

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