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 | Cassaforte apre 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 I Archiviazione 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
Cassaforte crea 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
Cassaforte crea 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
lp Archiviazione
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 I Archiviazione::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
lp Archiviazione
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 I Archiviazione::OpenStream in Windows SDK.
Vedi anche
Commenti e suggerimenti
https://aka.ms/ContentUserFeedback.
Presto disponibile: Nel corso del 2024 verranno gradualmente disattivati i problemi di GitHub come meccanismo di feedback per il contenuto e ciò verrà sostituito con un nuovo sistema di feedback. Per altre informazioni, vedereInvia e visualizza il feedback per