Metode ISyncMgrSyncItemContainer::GetSyncItemEnumerator (syncmgr.h)

Artikel
03/04/2024

Mendapatkan antarmuka yang menghitung item sinkronisasi handler.

Sintaks

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

Parameter

[out] ppenum

Jenis: IEnumSyncMgrSyncItems**

Ketika metode ini kembali, berisi alamat pointer ke instans IEnumSyncMgrSyncItems . IEnumSyncMgrSyncItems dapat digunakan untuk mengambil antarmuka untuk setiap item sinkronisasi dalam set.

Nilai kembali

Jenis: HRESULT

Jika metode ini berhasil, metode ini mengembalikan S_OK. Jika tidak, kode kesalahan HRESULT akan dikembalikan.

Keterangan

Metode ini menggantikan metode EnumSyncMgrItems yang lebih lama. Metode lama mengembalikan antarmuka enumerator yang mengembalikan struktur SYNCMGRITEM untuk setiap item sinkronisasi. Untuk mendapatkan data yang sebelumnya disediakan oleh struktur tersebut, Sync Center memanggil QueryInterface pada antarmuka ISyncMgrSyncItem setiap item untuk meminta antarmuka ISyncMgrSyncItemInfo yang sesuai.

Jumlah item yang dijumlahkan dapat diperoleh melalui metode ISyncMgrSyncItemContainer::GetSyncItemCount .

Contoh

Contoh berikut menunjukkan implementasi metode ini.

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;
}

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 [hanya aplikasi desktop]
Target Platform	Windows
Header	syncmgr.h

Bagikan melalui