Método ISyncMgrSyncItemContainer::GetSyncItemEnumerator (syncmgr.h)

Obtém uma interface que enumera os itens de sincronização do manipulador.

Sintaxe

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

Parâmetros

[out] ppenum

Tipo: IEnumSyncMgrSyncItems**

Quando esse método retorna, contém o endereço de um ponteiro para uma instância IEnumSyncMgrSyncItems . IEnumSyncMgrSyncItems pode ser usado para recuperar uma interface para cada item de sincronização no conjunto.

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

Esse método substitui o método EnumSyncMgrItems mais antigo. O método mais antigo retornou uma interface de enumerador que retornou uma estrutura SYNCMGRITEM para cada item de sincronização. Para obter os dados fornecidos anteriormente por essa estrutura, o Sync Center chama QueryInterface na interface ISyncMgrSyncItem de cada item para solicitar uma interface ISyncMgrSyncItemInfo correspondente.

O número de itens enumerados pode ser obtido por meio do método ISyncMgrSyncItemContainer::GetSyncItemCount .

Exemplos

O exemplo a seguir mostra uma implementação desse método.

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;
}

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