IVssEnumObject：：Next 方法 (vss.h)

Next 方法會從指定的列舉物件清單中傳回指定的物件數目。

語法

HRESULT Next(
  [in]  ULONG           celt,
  [out] VSS_OBJECT_PROP *rgelt,
  [out] ULONG           *pceltFetched
);

[in] celt

要從列舉物件清單中讀取到 rgelt 緩衝區的項目數目。

[out] rgelt

呼叫端配置的緩衝區位址，接收包含傳回物件的 celtVSS_OBJECT_PROP 結構。這個參數是必要的，而且不能是 NULL。

[out] pceltFetched

在 rgelt 緩衝區中傳回的項目數目。

以下是這個方法的有效傳回碼。

要求傳回多個 VSS_OBJECT_PROP 物件時，傳回值S_FALSE表示已到達列舉清單的結尾。如果要求的物件比清單還多， Next 會傳回其餘的所有物件、將 pceltFetched 參數設定為非零值，然後傳回S_FALSE。

輸出 rgelt 參數必須指向包含 celtVSS_OBJECT_PROP 結構的已配置陣列，而且不能是 NULL。

呼叫者必須負責釋放 IVssEnumObject：：Next 所指向之VSS_OBJECT_PROP結構旁的 IVssEnumObject：：Next。

呼叫端必須將 CoTaskMemFree 用於傳回VSS_OBJECT_PROP結構中VSS_SNAPSHOT_PROP或VSS_PROVIDER_PROP物件中的每個字串值。

在 VSS_SNAPSHOT_PROP的情況下，可以手動完成此作業，也可以使用公用程式函式 VssFreeSnapshotProperties 。