Metode ISyncMgrSessionCreator::CreateSession (syncmgr.h)

Memberi tahu Pusat Sinkronisasi bahwa sinkronisasi item yang ditentukan telah dimulai.

Sintaks

HRESULT CreateSession(
  [in] LPCWSTR              pszHandlerID,
  [in] LPCWSTR              *ppszItemIDs,
  [in] ULONG                cItems,
  [in] ISyncMgrSyncCallback **ppCallback
);

Parameter

[in] pszHandlerID

Jenis: LPCWSTR

Penunjuk ke buffer yang berisi ID unik handler. 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, dikelola oleh handler yang ditentukan dalam pszHandlerID, untuk disinkronkan. Setiap ID memiliki panjang maksimum MAX_SYNCMGR_ID termasuk karakter null yang mengakhiri.

[in] cItems

Jenis: ULONG

Jumlah ID item yang terkandung dalam buffer yang direferensikan dalam ppszItemIDs.

[in] ppCallback

Jenis: ISyncMgrSyncCallback**

Alamat pointer ke instans ISyncMgrSyncCallback yang digunakan untuk melaporkan kemajuan dan peristiwa. Nilai ini bisa NULL jika tidak ada panggilan balik yang diperlukan.

Mengembalikan nilai

Jenis: HRESULT

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

Keterangan

PszHandlerID dan ppszItemID harus ditentukan.

Contoh

Contoh berikut menunjukkan kerangka implementasi metode ini.

STDMETHODIMP CMyDeviceHandler::Synchronize(...)
{
    ...
    ISyncMgrSyncCallback *pCallback = NULL;

    hr = pCreator->CreateSession(_pszHandlerID, ppszItemIDs, cItems, &pCallback);
    if (SUCCEEDED(hr))
    {
        // Perform synchronization.
    }

    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