Método ISyncMgrHandler::Enable (syncmgr.h)
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.
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 |