Interfaz ISyncMgrHandlerCollection (syncmgr.h)

Expone métodos que proporcionan un enumerador de identificadores de controlador de sincronización y crean instancias de esos controladores de sincronización.

Herencia

La interfaz ISyncMgrHandlerCollection hereda de la interfaz IUnknown . ISyncMgrHandlerCollection también tiene estos tipos de miembros:

Métodos

La interfaz ISyncMgrHandlerCollection tiene estos métodos.

ISyncMgrHandlerCollection::BindToHandler Crea una instancia de un controlador de sincronización especificado cuando lo llama el Centro de sincronización.
ISyncMgrHandlerCollection::GetHandlerEnumerator Obtiene un enumerador que proporciona acceso a los identificadores de los controladores de sincronización expuestos y administrados por el usuario.

Comentarios

El autor de un controlador de sincronización implementa esta interfaz para admitir varios dispositivos o equipos y sincronizar sus detalles de forma independiente. El Centro de sincronización usa la colección de controladores para solicitar la creación de instancias de controladores de sincronización individuales. ISyncMgrHandlerCollection también permite que un autor del controlador de sincronización agregue controladores dinámicamente al Centro de sincronización en lugar de registrar cada uno individualmente en el registro.

En el ejemplo siguiente se muestra una implementación de esquema de esta interfaz.

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	Value
Cliente mínimo compatible	Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	syncmgr.h