ISyncMgrSyncItemContainer::GetSyncItemEnumerator 方法 (syncmgr.h)

获取枚举处理程序的同步项的接口。

语法

HRESULT GetSyncItemEnumerator(
  [out] IEnumSyncMgrSyncItems **ppenum
);

参数

[out] ppenum

类型: IEnumSyncMgrSyncItems**

此方法返回时,包含指向 IEnumSyncMgrSyncItems 实例的指针的地址。 IEnumSyncMgrSyncItems 可用于检索集中每个同步项的接口。

返回值

类型: HRESULT

如果该方法成功,则返回 S_OK。 否则,将返回 HRESULT 错误代码。

注解

此方法替换旧的 EnumSyncMgrItems 方法。 旧方法返回枚举器接口,该接口为每个同步项返回 SYNCMGRITEM 结构。 若要获取以前由该结构提供的数据,同步中心在每个项的 ISyncMgrSyncItem 接口上调用 QueryInterface,以请求相应的 ISyncMgrSyncItemInfo 接口。

枚举项数可以通过 ISyncMgrSyncItemContainer::GetSyncItemCount 方法获取。

示例

以下示例演示此方法的实现。

STDMETHODIMP CMyDeviceHandler::GetSyncItemEnumerator(
    __out IEnumSyncMgrSyncItems **ppenum)
{
    *ppenum = NULL;

    // Load the items using a private class method.
    HRESULT hr = _LoadItems();

    if (SUCCEEDED(hr))
    {
        hr = CEnumSyncMgrSyncItems_CreateInstance(this,
                                                  IID_PPV_ARGS(ppenum));
    }

    return hr;
}

要求

要求
最低受支持的客户端 Windows Vista [仅限桌面应用]
最低受支持的服务器 Windows Server 2008 [仅限桌面应用]
目标平台 Windows
标头 syncmgr.h