Método ISyncMgrHandlerCollection::BindToHandler (syncmgr.h)

Cria uma instância de um manipulador de sincronização especificado quando chamado pelo Centro de Sincronização.

Sintaxe

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

Parâmetros

[in] pszHandlerID

Tipo: LPCWSTR

A ID do manipulador de sincronização.

[in] riid

Tipo: REFIID

O IID da interface solicitada. Normalmente, isso será IID_ISyncMgrHandler. Se o método falhar quando passado IID_ISyncMgrHandler, ele será chamado de volta usando IID_ISyncMgrSynchronize, o IID da interface ISyncMgrSynchronize mais antiga. Quando o método retorna com êxito, um ponteiro para a interface solicitada é referenciado no parâmetro ppv .

[out] ppv

Tipo: void**

Quando esse método retorna, contém um endereço de um ponteiro para uma interface que representa o manipulador de sincronização.

Valor retornado

Tipo: HRESULT

Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Comentários

É possível que esse método seja chamado pelo Sync Center sem que ele primeiro chame ISyncMgrHandlerCollection::GetHandlerEnumerator. Isso ocorre porque o Sync Center armazena em cache informações sobre manipuladores e seus itens. A coleção de manipuladores pode retornar um ponteiro de interface para um manipulador de sincronização existente ou pode criar uma nova instância.

Requisitos

Confira também

ISyncMgrHandler

ISyncMgrHandlerCollection