Interface ISyncMgrHandlerCollection (syncmgr.h)

Expõe métodos que fornecem um enumerador de IDs do manipulador de sincronização e instanciam esses manipuladores de sincronização.

Herança

A interface ISyncMgrHandlerCollection herda da interface IUnknown . ISyncMgrHandlerCollection também tem estes tipos de membros:

Métodos

A interface ISyncMgrHandlerCollection tem esses métodos.

ISyncMgrHandlerCollection::BindToHandler Cria uma instância de um manipulador de sincronização especificado quando chamado pelo Centro de Sincronização.
ISyncMgrHandlerCollection::GetHandlerEnumerator Obtém um enumerador que fornece acesso às IDs de manipuladores de sincronização expostos e gerenciados pelo usuário.

Comentários

O autor de um manipulador de sincronização implementa essa interface para dar suporte a vários dispositivos ou computadores e sincronizar seus detalhes de forma independente. O Sync Center usa a coleção de manipuladores para solicitar a instanciação de manipuladores de sincronização individuais. ISyncMgrHandlerCollection também permite que um autor do manipulador de sincronização adicione manipuladores dinamicamente ao Sync Center em vez de registrar cada um individualmente no registro.

O exemplo a seguir mostra uma implementação de estrutura de tópicos dessa interface.

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

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	syncmgr.h