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