Metode ISyncMgrControl::StartItemSync (syncmgr.h)

Artikel
03/13/2024

Memulai sinkronisasi item tertentu yang dikelola oleh handler tertentu.

Sintaks

HRESULT StartItemSync(
  [in] LPCWSTR                    pszHandlerID,
  [in] LPCWSTR                    *ppszItemIDs,
  [in] ULONG                      cItems,
  [in] HWND                       hwndOwner,
  [in] IUnknown                   *punk,
  [in] SYNCMGR_SYNC_CONTROL_FLAGS nSyncControlFlags,
  [in] ISyncMgrSyncResult         *pResult
);

Parameter

[in] pszHandlerID

Jenis: LPCWSTR

Penunjuk ke buffer yang berisi ID unik handler yang mengelola item. String ini memiliki panjang maksimum MAX_SYNCMGR_ID termasuk karakter null yang mengakhiri.

[in] ppszItemIDs

Jenis: LPCWSTR*

Alamat penunjuk ke buffer yang berisi array ID item yang akan disinkronkan. Setiap ID memiliki panjang maksimum MAX_SYNCMGR_ID termasuk karakter null yang mengakhiri. Array ini diteruskan ke Sinkronkan.

[in] cItems

Jenis: DWORD

Jumlah ID dalam ppszItemID.

[in] hwndOwner

Jenis: HWND

Handel ke jendela yang dapat digunakan item untuk menampilkan UI yang diperlukan. Nilai ini bisa NULL.

[in] punk

Jenis: IUnknown*

Penunjuk ke IUnknown untuk diteruskan ke Sinkronkan. Parameter ini bisa NULL.

[in] nSyncControlFlags

Jenis: SYNCMGR_SYNC_CONTROL_FLAGS

Anggota enumerasi SYNCMGR_SYNC_CONTROL_FLAGS yang menentukan apakah item yang ditemukan dalam sinkronisasi saat ini dan sinkronisasi antrean harus disinkronkan lagi ketika sinkronisasi antrean dilakukan.

[in] pResult

Jenis: ISyncMgrSyncResult*

Penunjuk ke instans ISyncMgrSyncResult, yang metode Hasilnya dipanggil ketika sinkronisasi berakhir, baik melalui keberhasilan, kegagalan, atau pembatalan. Metode Hasil dipanggil dengan status agregat sinkronisasi handler. Parameter ini bisa NULL.

Mengembalikan nilai

Jenis: HRESULT

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

Keterangan

Metode ini dianalogikan dengan UpdateItems.

Contoh

Contoh berikut menunjukkan penggunaan ISyncMgrControl::StartItemSync dengan prosedur handler.

void CMyDeviceHandler::MiscProc(...)
{
    ...

    // Get the Sync Center control object.
    ISyncMgrControl *pControl = NULL;
    
    hr = CoCreateInstance(CLSID_SyncMgrControl, 
                          CLSCTX_SERVER,
                          IID_PPV_ARGS(&pControl));
    if (SUCCEEDED(hr))
    {
        // Synchronize one sync item for the sync handler.
        hr = pControl->StartItemSync(s_szMySyncHandlerID,
                                     s_szMySyncHandlerMusicContentID,
                                     1,
                                     _hwnd,
                                     NULL,
                                     NULL);
        pControl->Release();
    }

    ...

}

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