ISyncMgrSyncItemContainer::GetSyncItemEnumerator 메서드(syncmgr.h)

처리기의 동기화 항목을 열거하는 인터페이스를 가져옵니다.

구문

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

매개 변수

[out] ppenum

형식: IEnumSyncMgrSyncItems**

이 메서드가 반환되면 는 IEnumSyncMgrSyncItems instance 대한 포인터의 주소를 포함합니다. 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;
}

요구 사항