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à
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.