ISyncMgrSyncItemContainer：：GetSyncItemEnumerator 方法 (syncmgr.h)

取得列舉處理程式同步專案的介面。

語法

HRESULT GetSyncItemEnumerator(
  [out] IEnumSyncMgrSyncItems **ppenum
);

參數

[out] ppenum

類型： IEnumSyncMgrSyncItems**

當這個方法傳回時，會包含 IEnumSyncMgrSyncItems 實例指標的位址。 IEnumSyncMgrSyncItems 可用來擷取集合中每個同步專案的介面。

傳回值

類型： HRESULT

如果此方法成功，則會傳回 S_OK。 否則，它會傳回 HRESULT 錯誤碼。

備註

這個方法會取代較舊的 EnumSyncMgrItems 方法。 較舊的方法會傳回列舉值介面，這個介面會針對每個同步項目傳回 SYNCMGRITEM 結構。 若要取得先前由該結構提供的數據，Sync Center 會在每個專案的 ISyncMgrSyncItem 介面上呼叫 QueryInterface，以要求對應的 ISyncMgrSyncItemInfo 介面。

您可以透過 ISyncMgrSyncItemContainer：：GetSyncItemCount 方法取得列舉項目的數目。

範例

下列範例示範這個方法的實作。

STDMETHODIMP CMyDeviceHandler::GetSyncItemEnumerator(
    __out IEnumSyncMgrSyncItems **ppenum)
{
    *ppenum = NULL;

    // Load the items using a private class method.
    HRESULT hr = _LoadItems();

    if (SUCCEEDED(hr))
    {
        hr = CEnumSyncMgrSyncItems_CreateInstance(this,
                                                  IID_PPV_ARGS(ppenum));
    }

    return hr;
}

規格需求

需求	值
最低支援的用戶端	Windows Vista [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2008 [僅限傳統型應用程式]
目標平台	Windows
標頭	syncmgr.h