ISyncMgrHandlerCollection-Schnittstelle (syncmgr.h)

  • Artikel

Macht Methoden verfügbar, die einen Enumerator von Synchronisierungshandler-IDs bereitstellen und diese Synchronisierungshandler instanziieren.

Vererbung

Die ISyncMgrHandlerCollection-Schnittstelle erbt von der IUnknown-Schnittstelle . ISyncMgrHandlerCollection verfügt auch über die folgenden Membertypen:

Methoden

Die ISyncMgrHandlerCollection-Schnittstelle verfügt über diese Methoden.

 
ISyncMgrHandlerCollection::BindToHandler

Instanziiert einen angegebenen Synchronisierungshandler, wenn er vom Sync Center aufgerufen wird.
ISyncMgrHandlerCollection::GetHandlerEnumerator

Ruft einen Enumerator ab, der Zugriff auf die IDs von Synchronisierungshandlern bietet, die dem Benutzer verfügbar gemacht und vom Benutzer verwaltet werden.

Hinweise

Der Autor eines Synchronisierungshandlers implementiert diese Schnittstelle, um mehrere Geräte oder Computer zu unterstützen und deren Details unabhängig zu synchronisieren. Sync Center verwendet die Handlerauflistung, um die Instanziierung einzelner Synchronisierungshandler anzufordern. ISyncMgrHandlerCollection ermöglicht es einem Synchronisierungshandlerautor auch, Handler dynamisch zum Synchronisierungscenter hinzuzufügen, anstatt jeden einzeln in der Registrierung zu registrieren.

Das folgende Beispiel zeigt eine Gliederungsimplementierung dieser Schnittstelle.

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

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile syncmgr.h