(syncmgr.h) ISyncMgrHandlerCollection 介面

公開方法，提供同步處理程式標識碼的列舉值，並具現化這些同步處理程式。

繼承

ISyncMgrHandlerCollection 介面繼承自 IUnknown 介面。 ISyncMgrHandlerCollection 也有下列類型的成員：

方法

ISyncMgrHandlerCollection 介面具有這些方法。

ISyncMgrHandlerCollection：：BindToHandler 由同步中心呼叫時，具現化指定的同步處理程式。
ISyncMgrHandlerCollection：：GetHandlerEnumerator 取得列舉值，這個列舉值可讓您存取公開給使用者及管理之同步處理程式的標識碼。

備註

同步處理程式的作者會實作此介面來支援多個裝置或計算機，並獨立同步處理其詳細數據。 同步中心會使用處理程式集合來要求個別同步處理程式的具現化。 ISyncMgrHandlerCollection 也允許同步處理程式作者動態地將處理程式新增至同步中心，而不是在登錄中個別註冊每個處理程式。

下列範例顯示這個介面的大綱實作。

class CMyHandlerCollection : public ISyncMgrHandlerCollection
{
public:
    // IUnknown
    // ISyncMgrHandlerCollection
    IFACEMETHODIMP GetHandlerEnumerator(__out IEnumString **ppenum);
    IFACEMETHODIMP BindToHandler(
        __in LPCWSTR    pszHandlerID,
        __in REFIID     riid,
        __out void    **ppv);
};

STDMETHODIMP CMyHandlerCollection::GetHandlerEnumerator(
    __out IEnumString **ppenum)
{
    // IDs are retrieved from a data source such as the registry.
    // IDs could be retrieved either by this collection class 
    // or the factory method.
    return CEnumMyHandlerIDs_Create(ppenum);
}

STDMETHODIMP CMyHandlerCollection::BindToHandler(
    __in LPCWSTR    pszHandlerID,
    __in REFIID     riid,
    __out void    **ppv)
{
    // Map the pszHandlerID to the handler to create. This could be done
    // by the factory method or by some other method.
    return CMyHandler_Create(pszHandlerID, riid, ppv);
}

規格需求

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