COleStreamFile-klasse

Vertegenwoordigt een gegevensstroom (IStream) in een samengesteld bestand als onderdeel van OLE Structured Storage.

Syntaxis

class COleStreamFile : public CFile

Leden

Openbare constructors

Openbare methoden

Opmerkingen

Er moet een IStorage-object bestaan voordat de stream kan worden geopend of gemaakt, tenzij het een geheugenstroom is.

COleStreamFile objecten worden precies zo gemanipuleerd als CFile--objecten.

Zie het artikel Containers: Compound Filesvoor meer informatie over het bewerken van streams en opslag.

Zie IStream en IStorage in de Windows SDK voor meer informatie.

Overnamehiërarchie

CObject-

CFile-

COleStreamFile

Eisen

koptekst: afxole.h

COleStreamFile::Attach

Koppelt de opgegeven OLE-stroom aan het COleStreamFile-object.

void Attach(LPSTREAM lpStream);

Parameters

lpStream-
Verwijst naar de OLE-stroom (IStream) die aan het object moet worden gekoppeld. Kan niet NULL zijn.

Opmerkingen

Het object mag nog niet zijn gekoppeld aan een OLE-stroom.

Zie IStream in de Windows SDK voor meer informatie.

COleStreamFile::COleStreamFile

Hiermee maakt u een COleStreamFile-object.

COleStreamFile(LPSTREAM lpStream = NULL);

Parameters

lpStream-
Aanwijzer naar de OLE-stroom die aan het object moet worden gekoppeld.

Opmerkingen

Als lpStream NULL is, is het object niet gekoppeld aan een OLE-stroom, anders is het object gekoppeld aan de opgegeven OLE-stroom.

Zie IStream in de Windows SDK voor meer informatie.

COleStreamFile::CreateMemoryStream

Hiermee maakt u veilig een nieuwe stream uit het algemeen, gedeeld geheugen waarbij een fout een normale, verwachte voorwaarde is.

BOOL CreateMemoryStream(CFileException* pError = NULL);

Parameters

pError-
Verwijst naar een CFileException object of NULL dat de voltooiingsstatus van de maakbewerking aangeeft. Geef deze parameter op als u mogelijke uitzonderingen wilt bewaken die zijn gegenereerd door de stream te maken.

Retourwaarde

Niet-nul als de stream is gemaakt; anders 0.

Opmerkingen

Het geheugen wordt toegewezen door het OLE-subsysteem.

Zie CreateStreamOnHGlobal in de Windows SDK voor meer informatie.

COleStreamFile::CreateStream

Hiermee maakt u veilig een nieuwe stream in het opgegeven opslagobject, waarbij een fout een normale, verwachte voorwaarde is.

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

Parameters

lpStorage-
Verwijst naar het OLE-opslagobject dat de stream bevat die moet worden gemaakt. Kan niet NULL zijn.

lpszStreamName-
De naam van de stream die moet worden gemaakt. Kan niet NULL zijn.

nOpenFlags-
De toegangsmodus die moet worden gebruikt bij het openen van de stream. Exclusieve modi voor lezen/schrijven en maken worden standaard gebruikt. Zie CFile::CFilevoor een volledige lijst met beschikbare modi.

pError-
Verwijst naar een CFileException object of NULL. Geef deze parameter op als u mogelijke uitzonderingen wilt bewaken die zijn gegenereerd door de stream te maken.

Retourwaarde

Niet-nul als de stream is gemaakt; anders 0.

Opmerkingen

Er wordt een bestandsonderzondering gegenereerd als het openen mislukt en pError- niet NULL is.

Zie IStorage::CreateStream in de Windows SDK voor meer informatie.

COleStreamFile::D etach

Koppelt de stroom los van het object zonder de stroom te sluiten.

LPSTREAM Detach();

Retourwaarde

Een aanwijzer naar de stroom (IStream) die aan het object is gekoppeld.

Opmerkingen

De stream moet op een andere manier worden gesloten voordat het programma wordt beëindigd.

Zie IStream in de Windows SDK voor meer informatie.

COleStreamFile::GetStream

Roep deze functie aan om een aanwijzer naar de huidige stroom te retourneren.

IStream* GetStream() const;

Retourwaarde

Een aanwijzer naar de huidige stroominterface (IStream).

COleStreamFile::OpenStream

Hiermee opent u een bestaande stream.

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

Parameters

lpStorage-
Verwijst naar het OLE-opslagobject dat de stream bevat die moet worden geopend. Kan niet NULL zijn.

lpszStreamName-
De naam van de stream die moet worden geopend. Kan niet NULL zijn.

nOpenFlags-
De toegangsmodus die moet worden gebruikt bij het openen van de stream. Exclusieve en lees-/schrijfmodi worden standaard gebruikt. Zie CFile::CFilevoor de volledige lijst met beschikbare modi.

pError-
Verwijst naar een CFileException object of NULL. Geef deze parameter op als u mogelijke uitzonderingen wilt bewaken die zijn gegenereerd door de stream te openen.

Retourwaarde

Niet-nul als de stream is geopend; anders 0.

Opmerkingen

Er wordt een bestandsonderzondering gegenereerd als het openen mislukt en pError- niet NULL is.

Zie IStorage::OpenStream in de Windows SDK voor meer informatie.

Zie ook

CFile-klasse
Hiërarchiegrafiek