Compartir a través de

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

  • Artículo

Obtiene una interfaz que enumera los elementos de sincronización del controlador.

Sintaxis

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

Parámetros

[out] ppenum

Tipo: IEnumSyncMgrSyncItems**

Cuando este método devuelve, contiene la dirección de un puntero a una instancia de IEnumSyncMgrSyncItems . IEnumSyncMgrSyncItems se puede usar para recuperar una interfaz para cada elemento de sincronización del conjunto.

Valor devuelto

Tipo: HRESULT

Si este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.

Comentarios

Este método reemplaza al método EnumSyncMgrItems anterior. El método anterior devolvió una interfaz de enumerador que devolvió una estructura SYNCMGRITEM para cada elemento de sincronización. Para obtener los datos proporcionados anteriormente por esa estructura, el Centro de sincronización llama a QueryInterface en la interfaz ISyncMgrSyncItem de cada elemento para solicitar una interfaz ISyncMgrSyncItemInfo correspondiente.

El número de elementos enumerados se puede obtener a través del método ISyncMgrSyncItemContainer::GetSyncItemCount .

Ejemplos

En el ejemplo siguiente se muestra una implementación de este 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 Value
Cliente mínimo compatible Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado syncmgr.h