ISyncMgrHandlerCollection::BindToHandler メソッド (syncmgr.h)

Sync Center によって呼び出されたときに、指定された同期ハンドラーをインスタンス化します。

構文

HRESULT BindToHandler(
  [in]  LPCWSTR pszHandlerID,
  [in]  REFIID  riid,
  [out] void    **ppv
);

パラメーター

[in] pszHandlerID

種類: LPCWSTR

同期ハンドラーの ID。

[in] riid

型: REFIID

要求されたインターフェイスの IID。 これは通常、IID_ISyncMgrHandlerされます。 メソッドがIID_ISyncMgrHandler渡されたときに失敗した場合は、古い ISyncMgrSynchronize インターフェイスの IID IID_ISyncMgrSynchronizeを使用して呼び出されます。 メソッドが正常に返されると、要求されたインターフェイスへのポインターが ppv パラメーターで参照されます。

[out] ppv

型: void**

このメソッドが戻るときに、 には、同期ハンドラーを表すインターフェイスへのポインターのアドレスが含まれます。

戻り値

型: HRESULT

このメソッドは、成功すると S_OK を返します。 そうでない場合は、HRESULT エラー コードを返します。

解説

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

要件

サポートされている最小のクライアント	Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows Server 2008 [デスクトップ アプリのみ]
対象プラットフォーム	Windows
ヘッダー	syncmgr.h

関連項目

ISyncMgrHandler

ISyncMgrHandlerCollection