Interfaccia ISyncMgrHandlerCollection (syncmgr.h)

Espone i metodi che forniscono un enumeratore di ID del gestore di sincronizzazione e crea un'istanza di tali gestori di sincronizzazione.

Ereditarietà

L'interfaccia ISyncMgrHandlerCollection eredita dall'interfaccia IUnknown . ISyncMgrHandlerCollection include anche questi tipi di membri:

Metodi

L'interfaccia ISyncMgrHandlerCollection include questi metodi.

Commenti

L'autore di un gestore di sincronizzazione implementa questa interfaccia per supportare più dispositivi o computer e sincronizzare i dettagli in modo indipendente. Sync Center usa la raccolta del gestore per richiedere l'istanza dei singoli gestori di sincronizzazione. ISyncMgrHandlerCollection consente anche a un autore del gestore di sincronizzazione di aggiungere i gestori in modo dinamico al Centro sincronizzazione anziché registrarne uno singolarmente nel Registro di sistema.

Nell'esempio seguente viene illustrata un'implementazione struttura di questa interfaccia.

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);
}

Requisiti