Partager via

COleStreamFile, classe

  • Article

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 Ouvre en toute sécurité 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 IStorage 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

Crée en toute sécurité un flux hors du monde, de la mémoire 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

Crée en toute sécurité 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

lpStorage
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 IStorage ::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

lpStorage
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 IStorage ::OpenStream dans le Kit de développement logiciel (SDK) Windows.

Voir aussi

CFile, classe
Graphique hiérarchique