Metodo ISyncMgrSyncItemContainer::GetSyncItemEnumerator (syncmgr.h)

Articolo
03/02/2024

Ottiene un'interfaccia che enumera gli elementi di sincronizzazione del gestore.

Sintassi

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

Parametri

[out] ppenum

Tipo: IEnumSyncMgrSyncItems**

Quando questo metodo restituisce, contiene l'indirizzo di un puntatore a un'istanza di IEnumSyncMgrSyncItems . IEnumSyncMgrSyncItems può essere usato per recuperare un'interfaccia per ogni elemento di sincronizzazione nel set.

Valore restituito

Tipo: HRESULT

Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

Questo metodo sostituisce il metodo EnumSyncMgrItems precedente. Il metodo precedente ha restituito un'interfaccia enumeratore che ha restituito una struttura SYNCMGRITEM per ogni elemento di sincronizzazione. Per ottenere i dati forniti in precedenza da tale struttura, Sync Center chiama QueryInterface nell'interfaccia ISyncMgrSyncItem di ogni elemento per richiedere un'interfaccia ISyncMgrSyncItemInfo corrispondente.

Il numero di elementi enumerati può essere ottenuto tramite il metodo ISyncMgrSyncItemContainer::GetSyncItemCount .

Esempio

Nell'esempio seguente viene illustrata un'implementazione di questo metodo.

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

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	syncmgr.h

Condividi tramite