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

Habilita ou desabilita o item de sincronização.

Sintaxe

HRESULT Enable(
  [in] BOOL fEnable
);

Parâmetros

[in] fEnable

Tipo: BOOL

TRUE para habilitar; FALSE para desabilitar.

Retornar valor

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

A Central de Sincronização chama esse método nos cenários a seguir.

• Quando o usuário seleciona o item na pasta do manipulador e inicia sua tarefa Habilitar , mas somente se o item não tiver definido o sinalizador SYNCMGR_IPM_PREVENT_ENABLE . Se o manipulador der suporte ao objeto SYNCMGR_OBJECTID_QueryBeforeEnable , esse método só será chamado se a operação de interface do usuário tiver sido bem-sucedida.
• Quando o usuário seleciona o item na pasta do manipulador e inicia sua tarefa Desabilitar , mas somente se o item não tiver definido o sinalizador SYNCMGR_IPM_PREVENT_DISABLE . Se o manipulador der suporte ao objeto SYNCMGR_OBJECTID_QueryBeforeDisable , esse método só será chamado se a operação de 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 CMyDeviceSyncItem::Enable(__in BOOL fEnable)
{
    return E_NOTIMPL;
}

Requisitos

Requisito	Valor
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