共用方式為


IEnumWbemClassObject::Next 方法 (wbemcli.h)

使用 IEnumWbemClassObject::Next 方法來取得從列舉中目前位置開始的一或多個物件。 此方法會將列舉中的目前位置前移 uCount 物件,以便後續呼叫傳回後續的物件。

語法

HRESULT Next(
  [in]  long             lTimeout,
  [in]  ULONG            uCount,
  [out] IWbemClassObject **apObjects,
  [out] ULONG            *puReturned
);

參數

[in] lTimeout

指定呼叫在傳回之前封鎖的最大時間量,以毫秒為單位。 如果您使用常數 WBEM_INFINITE (0xFFFFFFFF) ,則呼叫會封鎖直到物件可用為止。 如果您使用值 0 (WBEM_NO_WAIT) ,則呼叫會立即傳回,不論是否有任何物件可用。

[in] uCount

要求的物件數目。

[out] apObjects

足夠記憶體的指標,可保存 uCount 所指定的 IWbemClassObject 介面指標數目。 呼叫端必須提供此記憶體。 此參數不可為 NULL。 當不再需要時,呼叫端必須在每個收到的介面指標上呼叫 Release

[out] puReturned

ULONG 的指標,該 ULONG 會接收傳回的物件數目。 此數位可以小於 uCount 中所要求的數位。 此指標不可為 NULL

注意 當您到達列舉結尾時, Next 方法會 傳回WBEM_S_FALSE ,即使已成功傳回物件也一樣。 只有在傳回的物件數目符合 uCount 中要求的數目時,WBEM_S_NO_ERROR值才會傳回。 傳回的物件數目小於所要求的數目,但您不在列舉結尾時,會傳回 WBEM_S_TIMEDOUT 值。 因此,您應該使用迴圈終止邏輯來檢查 puReturned 值,以確保您已到達列舉的結尾。
 

傳回值

Next 方法會傳回 HRESULT,指出方法呼叫的狀態。 下列清單列出 HRESULT 中包含的值。

備註

如果網路問題造成您遺失與 Windows 管理的遠端連線,您可能會看到傳回 COM 特定的錯誤碼。 發生錯誤時,您可以呼叫 COM 函式 GetErrorInfo 以取得更多錯誤資訊。

如果要求多個物件,而且傳回要求的物件數目,函式會 傳回WBEM_S_NO_ERROR。 如果可用的物件數目小於所要求的物件數目,而且列舉已完成,則會傳回這些物件,而且函式會 傳回WBEM_S_FALSE

如果列舉尚未完成,則呼叫會等候物件可用到指定的逾時。如果列舉在物件可用之前逾時,函式會 傳回WBEM_S_TIMEDOUT

注意 由於對接收的回呼可能不會在用戶端所需的相同驗證層級傳回,因此建議您使用半同步而非異步通訊。 如需詳細資訊,請參閱 呼叫方法
 

範例

如需在 C++ 和 WMI 中進行查詢的擴充討論和範例,請參閱 在 CodeProject 上以 C++ 製作 WMI 查詢

在下列程式代碼中,要求多個物件:
HRESULT ProcessEnum( IEnumWbemClassObject*    pEnum )
{
    HRESULT    hRes = WBEM_S_NO_ERROR;

    // Final Next will return WBEM_S_FALSE
    while ( WBEM_S_NO_ERROR == hRes )
    {
        ULONG            uReturned;
        IWbemClassObject*    apObj[10];

        hRes = pEnum->Next( WBEM_INFINITE, 10, apObj, &uReturned );

        if ( SUCCEEDED( hRes ) )
        {
            // Do something with the objects.
            //ProcessObjects( uReturned,  apObj );

            for ( ULONG n = 0; n < uReturned; n++ )
            {
                apObj[n]->Release();
            }

        }    // If Enum succeeded...
    }    // While Enum is returning objects...

    return hRes;
}

規格需求

需求
最低支援的用戶端 Windows Vista
最低支援的伺服器 Windows Server 2008
目標平台 Windows
標頭 wbemcli.h (包含 Wbemidl.h)
程式庫 Wbemuuid.lib
Dll Fastprox.dll

另請參閱

列舉 WMI

IEnumWbemClassObject