Metodo IStream::Clone (objidl.h)
Il metodo Clone crea un nuovo oggetto di flusso con un puntatore di ricerca personalizzato che fa riferimento agli stessi byte del flusso originale.
Sintassi
HRESULT Clone(
[out] IStream **ppstm
);
Parametri
[out] ppstm
Al termine, puntatore alla posizione di un puntatore IStream al nuovo oggetto di flusso. Se si verifica un errore, questo parametro è NULL.
Valore restituito
Questo metodo può restituire uno di questi valori.
Codice restituito | Descrizione |
---|---|
S_OK | Il flusso è stato clonato correttamente. |
E_PENDING | Solo archiviazione asincrona: parte o tutti i dati del flusso non sono attualmente disponibili. |
STG_E_INSUFFICIENTMEMORY | Il flusso non è stato clonato a causa di una mancanza di memoria. |
STG_E_INVALIDPOINTER | Il puntatore ppStm non è valido. |
STG_E_REVERTED | L'oggetto è stato invalidato da un'operazione di ripristino sopra di essa nell'albero delle transazioni. |
Commenti
Il metodo Clone crea un nuovo oggetto di flusso per accedere allo stesso byte, ma usando un puntatore di ricerca separato. Il nuovo oggetto di flusso visualizza gli stessi dati dell'oggetto di flusso di origine. Le modifiche scritte in un oggetto sono immediatamente visibili nell'altro. Il blocco dell'intervallo è condiviso tra gli oggetti di flusso.
L'impostazione iniziale del puntatore di ricerca nell'istanza del flusso clonato corrisponde all'impostazione corrente del puntatore di ricerca nel flusso originale al momento dell'operazione di clonazione.
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 |
Libreria | Uuid.lib |
DLL | Ole32.dll |