IEnumCERTVIEWROW：：Next 方法 (certview.h)

Next 方法會移至數據列列舉序列中的下一個數據列。

語法

HRESULT Next(
  [out] LONG *pIndex
);

參數

[out] pIndex

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

傳回值

C++

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

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

VB

傳回值是數據列列舉序列目前所參考之數據列的索引值。 如果沒有其他要列舉的數據列，則傳回值為 –1。

備註

成功完成此方法之後，可以使用下列介面的方法列舉與數據列中憑證相關聯的數據行、屬性和延伸模組：

• IEnumCERTVIEWCOLUMN
• IEnumCERTVIEWATTRIBUTE
• IEnumCERTVIEWEXTENSION

根據涉及的查詢和序列大小而定，迴圈查看列舉序列中的所有數據列，可能會耗用大量資源來計算。

範例

// pEnumRow is previously instantiated pointer to IEnumCERTVIEWROW.
LONG  Index;
LONG  nCount;

// Ensure enumerator is at first row.
if (FAILED(pEnumRow->Reset()))
    printf("Failed to Reset\n");
else
{
    nCount = 0;
    // Count the database records by enumerating the rows.
    while (S_OK == pEnumRow->Next(&Index))
        nCount++;
    // Display number of records.
    printf("Number of records is %d\n", nCount);
}

規格需求

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

另請參閱

IEnumCERTVIEWATTRIBUTE

IEnumCERTVIEWCOLUMN

IEnumCERTVIEWEXTENSION

IEnumCERTVIEWROW