Share via

Método ISyncMgrHandler::Enable (syncmgr.h)

  • Artigo

Solicita que um manipulador ativo seja habilitado ou desabilitado. Um manipulador habilitado pode ser sincronizado e um manipulador desabilitado não pode.

Sintaxe

HRESULT Enable(
  [in] BOOL fEnable
);

Parâmetros

[in] fEnable

Tipo: BOOL

TRUE para habilitar; FALSE para desabilitar.

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

Um manipulador deve definir os sinalizadores SYNCMGR_HCM_CAN_ENABLE e SYNCMGR_HCM_CAN_DISABLE para que as entradas Habilitar e Desabilitar apareçam no menu de atalho do manipulador quando o manipulador for mostrado na pasta Central de Sincronização. Escolher habilitar um manipulador significa que ele pode ser sincronizado; escolher desabilitar um manipulador significa que ele não pode.

O Sync Center chama esse método nas duas instâncias a seguir.

  • Quando o usuário seleciona o manipulador na pasta Central de Sincronização e inicia sua tarefa Habilitar . Se o manipulador der suporte ao objeto SYNCMGR_OBJECTID_QueryBeforeEnable , esse método só será chamado se a operação da interface do usuário tiver sido bem-sucedida.
  • Quando o usuário seleciona o manipulador na pasta Central de Sincronização e inicia sua tarefa Desabilitar . Se o manipulador der suporte ao objeto SYNCMGR_OBJECTID_QueryBeforeDisable , esse método só será chamado se a operação da interface do usuário tiver sido bem-sucedida.
Se o manipulador não precisar executar nenhuma ação quando estiver ativado, ele poderá retornar S_OK ou E_NOTIMPL conforme mostrado no exemplo abaixo.

Exemplos

O exemplo a seguir mostra uma implementação simples desse método.

STDMETHODIMP CMyDeviceHandler::Enable(__in BOOL fEnable)
{
    return E_NOTIMPL;
}

Requisitos

   
Cliente mínimo com suporte Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho syncmgr.h

Confira também

ISyncMgrHandler

ISyncMgrHandler::GetObject

IsEnabled