ISyncMgrSyncItemInfo：：IsEnabled 方法 (syncmgr.h)

生成一个值，该值指示是否启用该项。

语法

HRESULT IsEnabled();

类型： HRESULT

如果启用该项，则返回S_OK;否则，S_FALSE。

如果项目希望同步中心保持当前状态，它可以返回E_NOTIMPL。如果返回任何其他值，同步中心会将项目的启用状态设置为最后一个已知值，并根据需要启用或禁用关联的任务。

如果在从 GetCapabilities 返回的掩码中设置了SYNCMGR_ICM_QUERY_BEFORE_ENABLE或SYNCMGR_ICM_QUERY_BEFORE_DISABLE标志，则处理程序必须管理其自己的启用状态，因此必须返回S_OK或S_FALSE。任何其他返回值都将被视为错误。

如果某个项被禁用，则同步中心不会对其进行同步。此外，UI 中会删除或禁用项可用的许多操作（例如同步）。

项可以通过从 IsEnabled 返回S_FALSE并在其 GetPolicies 实现中设置SYNCMR_IPM_PREVENT_ENABLE标志来实现断开连接状态。这会将该项显示为已禁用，并阻止用户手动启用它。

已启用的值在文件夹 UI 中作为 System.Sync.Enabled (PKEY_Sync_Enabled) 属性提供。

每当调用 UpdateHandler 方法时，同步中心将调用此方法。

以下示例演示此方法的实现，该方法调用私有类函数来检索已启用的状态。

STDMETHODIMP CMyDeviceSyncItem::IsEnabled()
{
    // Return a previously-calculated value.
    return (_fIsEnabled ? S_OK : S_FALSE);
}