Condividi tramite


Classe COleStreamFile

Rappresenta un flusso di dati (IStream) in un file composito come parte di un archivio strutturato OLE.

Sintassi

class COleStreamFile : public CFile

Membri

Costruttori pubblici

Nome Descrizione
COleStreamFile::COleStreamFile Costruisce un oggetto COleStreamFile.

Metodi pubblici

Nome Descrizione
COleStreamFile::Attach Associa un flusso all'oggetto .
COleStreamFile::CreateMemoryStream Crea un flusso dalla memoria globale e lo associa all'oggetto .
COleStreamFile::CreateStream Crea un flusso e lo associa all'oggetto .
COleStreamFile::D etach Annulla l'associazione del flusso dall'oggetto .
COleStreamFile::GetStream Restituisce il flusso corrente.
COleStreamFile::OpenStream Apre in modo sicuro un flusso e lo associa all'oggetto .

Osservazioni:

Un IStorage oggetto deve esistere prima che il flusso possa essere aperto o creato, a meno che non sia un flusso di memoria.

COleStreamFile gli oggetti vengono modificati esattamente come gli oggetti CFile .

Per altre informazioni sulla modifica di flussi e archivi, vedere l'articolo Contenitori: File composti.

Per altre informazioni, vedere IStream e IStorage in Windows SDK.

Gerarchia di ereditarietà

CObject

CFile

COleStreamFile

Requisiti

Intestazione: afxole.h

COleStreamFile::Attach

Associa il flusso OLE fornito all'oggetto COleStreamFile .

void Attach(LPSTREAM lpStream);

Parametri

lpStream
Punta al flusso OLE (IStream) da associare all'oggetto . Non può essere NULL.

Osservazioni:

L'oggetto non deve essere già associato a un flusso OLE.

Per altre informazioni, vedere IStream in Windows SDK.

COleStreamFile::COleStreamFile

Crea un oggetto COleStreamFile.

COleStreamFile(LPSTREAM lpStream = NULL);

Parametri

lpStream
Puntatore al flusso OLE da associare all'oggetto .

Osservazioni:

Se lpStream è NULL, l'oggetto non è associato a un flusso OLE. In caso contrario, l'oggetto è associato al flusso OLE fornito.

Per altre informazioni, vedere IStream in Windows SDK.

COleStreamFile::CreateMemoryStream

Crea in modo sicuro un nuovo flusso fuori dalla memoria globale condivisa in cui un errore è una condizione normale e prevista.

BOOL CreateMemoryStream(CFileException* pError = NULL);

Parametri

pError
Punta a un oggetto CFileException o NULL che indica lo stato di completamento dell'operazione di creazione. Specificare questo parametro se si desidera monitorare le possibili eccezioni generate tentando di creare il flusso.

Valore restituito

Diverso da zero se il flusso viene creato correttamente; in caso contrario, 0.

Osservazioni:

La memoria viene allocata dal sottosistema OLE.

Per altre informazioni, vedere CreateStreamOnHGlobal in Windows SDK.

COleStreamFile::CreateStream

Crea in modo sicuro un nuovo flusso nell'oggetto di archiviazione fornito in cui un errore è una condizione normale e prevista.

BOOL CreateStream(
    LPSTORAGE lpStorage,
    LPCTSTR lpszStreamName,
    DWORD nOpenFlags = modeReadWrite|shareExclusive|modeCreate,
    CFileException* pError = NULL);

Parametri

lpStorage
Punta all'oggetto di archiviazione OLE che contiene il flusso da creare. Non può essere NULL.

lpszStreamName
Nome del flusso da creare. Non può essere NULL.

nOpenFlags
Modalità di accesso da usare quando si apre il flusso. Le modalità esclusivo, di lettura/scrittura e di creazione vengono usate per impostazione predefinita. Per un elenco completo delle modalità disponibili, vedere CFile::CFile.

pError
Punta a un oggetto CFileException o NULL. Specificare questo parametro se si desidera monitorare le possibili eccezioni generate tentando di creare il flusso.

Valore restituito

Diverso da zero se il flusso viene creato correttamente; in caso contrario, 0.

Osservazioni:

Se l'apertura ha esito negativo e pError non è NULL, verrà generata un'eccezione di file.

Per altre informazioni, vedere IStorage::CreateStream in Windows SDK.

COleStreamFile::D etach

Annulla l'associazione del flusso dall'oggetto senza chiudere il flusso.

LPSTREAM Detach();

Valore restituito

Puntatore al flusso (IStream) associato all'oggetto .

Osservazioni:

Il flusso deve essere chiuso in altro modo prima che il programma termini.

Per altre informazioni, vedere IStream in Windows SDK.

COleStreamFile::GetStream

Chiamare questa funzione per restituire un puntatore al flusso corrente.

IStream* GetStream() const;

Valore restituito

Puntatore all'interfaccia del flusso corrente ( IStream).

COleStreamFile::OpenStream

Apre un flusso esistente.

BOOL OpenStream(
    LPSTORAGE lpStorage,
    LPCTSTR lpszStreamName,
    DWORD nOpenFlags = modeReadWrite|shareExclusive,
    CFileException* pError = NULL);

Parametri

lpStorage
Punta all'oggetto di archiviazione OLE che contiene il flusso da aprire. Non può essere NULL.

lpszStreamName
Nome del flusso da aprire. Non può essere NULL.

nOpenFlags
Modalità di accesso da usare quando si apre il flusso. Le modalità esclusive e di lettura/scrittura vengono usate per impostazione predefinita. Per l'elenco completo delle modalità disponibili, vedere CFile::CFile.

pError
Punta a un oggetto CFileException o NULL. Specificare questo parametro se si desidera monitorare le possibili eccezioni generate tentando di aprire il flusso.

Valore restituito

Diverso da zero se il flusso viene aperto correttamente; in caso contrario, 0.

Osservazioni:

Se l'apertura ha esito negativo e pError non è NULL, verrà generata un'eccezione di file.

Per altre informazioni, vedere IStorage::OpenStream in Windows SDK.

Vedi anche

Classe CFile
Grafico della gerarchia