Metodo IEnumMoniker::Clone (objidl.h)

  • Articolo

Crea un nuovo enumeratore che contiene lo stesso stato di enumerazione di quello corrente.

Questo metodo consente di registrare un punto specifico nella sequenza di enumerazione e quindi tornare a quel punto in un secondo momento. Il chiamante deve rilasciare questo nuovo enumeratore separatamente dal primo enumeratore.

Sintassi

HRESULT Clone(
  [out] IEnumMoniker **ppenum
);

Parametri

[out] ppenum

Indirizzo di una variabile puntatore IEnumMoniker che riceve il puntatore dell'interfaccia all'oggetto di enumerazione. Se il metodo non riesce, il valore di questa variabile di output non è definito.

Valore restituito

Questo metodo restituisce S_OK se l'operazione ha esito positivo. Altri valori possibili includono quanto segue.

Codice restituito Descrizione
E_UNEXPECTED
 Si è verificato un errore imprevisto.
E_INVALIDARG
 L'enumeratore specificato non è valido.
E_OUTOFMEMORY
 Memoria insufficiente disponibile per questa operazione.

Requisiti

Requisito Valore
Client minimo supportato Windows 2000 Professional [app desktop | App UWP]
Server minimo supportato Windows 2000 Server [app desktop | App UWP]
Piattaforma di destinazione Windows
Intestazione objidl.h

Vedi anche

IEnumMoniker