Metodo IEnumFsiItems::Clone (imapi2fs.h)
Crea un altro enumeratore che contiene lo stesso stato di enumerazione di quello corrente.
Sintassi
HRESULT Clone(
[out] IEnumFsiItems **ppEnum
);
Parametri
[out] ppEnum
Riceve il puntatore dell'interfaccia all'oggetto di enumerazione. Se il metodo ha esito negativo, il valore di questa variabile di output non è definito. Al termine, è necessario rilasciare ppEnum .
Valore restituito
S_OK viene restituito in caso di esito positivo, ma altri codici di esito positivo possono essere restituiti in seguito all'implementazione. I codici di errore seguenti vengono comunemente restituiti in caso di errore dell'operazione, ma non rappresentano gli unici valori di errore possibili:
| Codice restituito | Descrizione |
|---|---|
|
Puntatore non valido.
Valore: 0x80004003 |
|
Impossibile allocare la memoria richiesta.
Valore: 0x8007000E |
Commenti
Usando questo metodo, un client può registrare un determinato punto nella sequenza di enumerazione e quindi tornare a quel punto in un secondo momento. Il nuovo enumeratore supporta la stessa interfaccia di quella originale.
Requisiti
| Client minimo supportato | Windows Vista, Windows XP con SP2 [solo app desktop] |
| Server minimo supportato | Windows Server 2003 [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | imapi2fs.h |