ISyncMgrSessionCreator：：CreateSession 方法 (syncmgr.h)

通知同步中心，指定專案的同步處理已開始。

語法

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

參數

[in] pszHandlerID

類型： LPCWSTR

緩衝區的指標，其中包含處理程式的唯一標識符。 此字串長度上限MAX_SYNCMGR_ID包括終止 Null 字元。

[in] ppszItemIDs

類型： LPCWSTR*

緩衝區指標的位址，其中包含要同步處理 之 pszHandlerID 中所指定處理程式所管理之專案標識子陣列的位址。 每個標識碼的長度上限MAX_SYNCMGR_ID包括終止 Null 字元。

[in] cItems

類型： ULONG

ppszItemIDs 所參考之緩衝區中包含的專案標識碼數目。

[in] ppCallback

類型： ISyncMgrSyncCallback**

用來報告進度和事件的 ISyncMgrSyncCallback 實例指標位址。 如果不需要回呼，此值可以是 NULL 。

傳回值

類型： HRESULT

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

備註

必須指定 pszHandlerID 和 ppszItemID。

範例

下列範例顯示此方法實作的大綱。

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

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

    return hr;
}

規格需求

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