ISyncMgrHandlerCollection

同期ハンドラー ID の列挙子を提供し、それらの同期ハンドラーをインスタンス化するメソッドを公開します。

同期ハンドラーの作成者は、複数のデバイスまたはコンピューターをサポートし、それぞれの詳細を個別に同期するためにこのインターフェイスを実装します。同期センターは、このハンドラー コレクションを使用して個々の同期ハンドラーのインスタンス化を要求します。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);
}

ユーザーに公開され、ユーザーによって管理される同期ハンドラーの ID にアクセスするための列挙子を取得します。

型: HRESULT

このメソッドが成功した場合は S_OK を返します。それ以外の場合は HRESULT エラー コードを返します。

同期ハンドラー ID は、そのハンドラーを一意に表す文字列です。この ID はシステム内のすべてのハンドラーにわたって一意でなければならず、終端の null 文字を含めて最大長 MAX_SYNCMGR_ID に制限されます。

以前のバージョンの Windows では、ハンドラー ID と項目 ID を表すために GUID を使用していました。Windows Vista では、より高い柔軟性のために文字列を使用します。一意性を保証するために文字列に GUID を含めることが引き続き推奨されますが、アプリケーションやデバイスに固有の、ハンドラーにとって有用なその他の情報を含めることもできます。

同期センターから呼び出されたときに、指定された同期ハンドラーをインスタンス化します。

型: HRESULT

このメソッドが成功した場合は S_OK を返します。それ以外の場合は HRESULT エラー コードを返します。

このメソッドは、同期センターが先に ISyncMgrHandlerCollection::GetHandlerEnumerator を呼び出さずに呼び出されることがあります。これは、同期センターがハンドラーとその項目に関する情報をキャッシュするためです。ハンドラー コレクションは、既存の同期ハンドラーのインターフェイス ポインターを返すことも、新しいインスタンスを作成することもできます。