共用方式為


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 錯誤碼。

備註

必須指定 pszHandlerIDppszItemID。

範例

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

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