COleStreamFile, classe

Représente un flux de données (IStream) dans un fichier composé dans le cadre du stockage structuré OLE.

Syntaxe

class COleStreamFile : public CFile

Membres

Constructeurs publics

Nom	Description
COleStreamFile ::COleStreamFile	Construit un objet COleStreamFile.

Méthodes publiques

Nom	Description
COleStreamFile ::Attach	Associe un flux à l’objet.
COleStreamFile ::CreateMemoryStream	Crée un flux à partir de la mémoire globale et l’associe à l’objet.
COleStreamFile ::CreateStream	Crée un flux et l’associe à l’objet.
COleStreamFile ::D etach	Dissocie le flux de l’objet.
COleStreamFile ::GetStream	Retourne le flux actuel.
COleStreamFile ::OpenStream	Coffre ouvrez un flux et l’associe à l’objet.

Notes

Un IStorage objet doit exister avant que le flux puisse être ouvert ou créé, sauf s’il s’agit d’un flux de mémoire.

COleStreamFile les objets sont manipulés exactement comme les objets CFile .

Pour plus d’informations sur la manipulation de flux et de stockages, consultez l’article Conteneurs : Fichiers composés..

Pour plus d’informations, consultez IStream et I Stockage dans le Kit de développement logiciel (SDK) Windows.

Hiérarchie d'héritage

CObject

CFile

COleStreamFile

Spécifications

En-tête : afxole.h

COleStreamFile ::Attach

Associe le flux OLE fourni à l’objet COleStreamFile .

void Attach(LPSTREAM lpStream);

Paramètres

lpStream
Pointe vers le flux OLE (IStream) à associer à l’objet. Ne peut pas avoir la valeur NULL.

Notes

L’objet ne doit pas déjà être associé à un flux OLE.

Pour plus d’informations, consultez IStream dans le Kit de développement logiciel (SDK) Windows.

COleStreamFile ::COleStreamFile

Crée un objet COleStreamFile.

COleStreamFile(LPSTREAM lpStream = NULL);

Paramètres

lpStream
Pointeur vers le flux OLE à associer à l’objet.

Notes

Si lpStream a la valeur NULL, l’objet n’est pas associé à un flux OLE ; sinon, l’objet est associé au flux OLE fourni.

Pour plus d’informations, consultez IStream dans le Kit de développement logiciel (SDK) Windows.

COleStreamFile ::CreateMemoryStream

Coffre crée un flux hors de la mémoire globale et partagée, où une défaillance est une condition normale et attendue.

BOOL CreateMemoryStream(CFileException* pError = NULL);

Paramètres

pError
Pointe vers un objet CFileException ou NULL qui indique l’état d’achèvement de l’opération de création. Fournissez ce paramètre si vous souhaitez surveiller les exceptions possibles générées en tentant de créer le flux.

Valeur de retour

Différent de zéro si le flux est créé avec succès ; sinon 0.

Notes

La mémoire est allouée par le sous-système OLE.

Pour plus d’informations, consultez CreateStreamOnHGlobal dans le Kit de développement logiciel (SDK) Windows.

COleStreamFile ::CreateStream

Coffre crée un flux dans l’objet de stockage fourni, où une défaillance est une condition normale et attendue.

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

Paramètres

lp Stockage
Pointe vers l’objet de stockage OLE qui contient le flux à créer. Ne peut pas avoir la valeur NULL.

lpszStreamName
Nom du flux à créer. Ne peut pas avoir la valeur NULL.

nOpenFlags
Mode d’accès à utiliser lors de l’ouverture du flux. Les modes exclusifs, en lecture/écriture et création sont utilisés par défaut. Pour obtenir la liste complète des modes disponibles, consultez CFile ::CFile.

pError
Pointe vers un objet CFileException ou NULL. Fournissez ce paramètre si vous souhaitez surveiller les exceptions possibles générées en tentant de créer le flux.

Valeur de retour

Différent de zéro si le flux est créé avec succès ; sinon 0.

Notes

Une exception de fichier est levée si l’ouverture échoue et que pError n’est pas NULL.

Pour plus d’informations, consultez I Stockage ::CreateStream dans le Kit de développement logiciel (SDK) Windows.

COleStreamFile ::D etach

Dissocie le flux de l’objet sans fermer le flux.

LPSTREAM Detach();

Valeur de retour

Pointeur vers le flux (IStream) associé à l’objet.

Notes

Le flux doit être fermé d’une autre manière avant que le programme ne se termine.

Pour plus d’informations, consultez IStream dans le Kit de développement logiciel (SDK) Windows.

COleStreamFile ::GetStream

Appelez cette fonction pour retourner un pointeur vers le flux actuel.

IStream* GetStream() const;

Valeur de retour

Pointeur vers l’interface de flux actuelle ( IStream).

COleStreamFile ::OpenStream

Ouvre un flux existant.

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

Paramètres

lp Stockage
Pointe vers l’objet de stockage OLE qui contient le flux à ouvrir. Ne peut pas avoir la valeur NULL.

lpszStreamName
Nom du flux à ouvrir. Ne peut pas avoir la valeur NULL.

nOpenFlags
Mode d’accès à utiliser lors de l’ouverture du flux. Les modes exclusifs et en lecture/écriture sont utilisés par défaut. Pour obtenir la liste complète des modes disponibles, consultez CFile ::CFile.

pError
Pointe vers un objet CFileException ou NULL. Fournissez ce paramètre si vous souhaitez surveiller les exceptions possibles générées en tentant d’ouvrir le flux.

Valeur de retour

Différent de zéro si le flux est ouvert avec succès ; sinon 0.

Notes

Une exception de fichier est levée si l’ouverture échoue et que pError n’est pas NULL.

Pour plus d’informations, consultez I Stockage ::OpenStream dans le Kit de développement logiciel (SDK) Windows.

Voir aussi

CFile, classe
Graphique hiérarchique