Dela via

COleStreamFile-klass

  • Artikel

Representerar en dataström (IStream) i en sammansatt fil som en del av OLE Structured Storage.

Syntax

class COleStreamFile : public CFile

Medlemmar

Offentliga konstruktorer

Namn Beskrivning
COleStreamFile::COleStreamFile Konstruerar ett COleStreamFile objekt.

Offentliga metoder

Namn Beskrivning
COleStreamFile::Attach Associerar en ström med objektet.
COleStreamFile::CreateMemoryStream Skapar en ström från det globala minnet och associerar den med objektet.
COleStreamFile::CreateStream Skapar en ström och associerar den med objektet.
COleStreamFile::D etach Kopplar bort strömmen från objektet.
COleStreamFile::GetStream Returnerar den aktuella strömmen.
COleStreamFile::OpenStream Öppnar en dataström på ett säkert sätt och associerar den med objektet.

Anmärkningar

Ett IStorage objekt måste finnas innan strömmen kan öppnas eller skapas om det inte är en minnesström.

COleStreamFile objekt ändras precis som CFile objekt.

Mer information om hur du manipulerar strömmar och lagringar finns i artikeln Containers: Compound Files.

Mer information finns i IStream och IStorage i Windows SDK.

Arvshierarki

CObject

CFile

COleStreamFile

Krav

rubrik: afxole.h

COleStreamFile::Attach

Associerar den angivna OLE-strömmen med COleStreamFile-objektet.

void Attach(LPSTREAM lpStream);

Parametrar

lpStream
Pekar på OLE-strömmen (IStream) som ska associeras med objektet. Det går inte att vara NULL.

Anmärkningar

Objektet får inte redan vara associerat med en OLE-ström.

Mer information finns i IStream i Windows SDK.

COleStreamFile::COleStreamFile

Skapar ett COleStreamFile objekt.

COleStreamFile(LPSTREAM lpStream = NULL);

Parametrar

lpStream
Pekare till OLE-strömmen som ska associeras med objektet.

Anmärkningar

Om lpStream- är NULL är objektet inte associerat med en OLE-ström, annars associeras objektet med den angivna OLE-strömmen.

Mer information finns i IStream i Windows SDK.

COleStreamFile::CreateMemoryStream

Skapar på ett säkert sätt en ny ström av globalt, delat minne där ett fel är ett normalt, förväntat villkor.

BOOL CreateMemoryStream(CFileException* pError = NULL);

Parametrar

pError
Pekar på ett CFileException-objekt eller NULL som anger slutförandestatus för åtgärden skapa. Ange den här parametern om du vill övervaka möjliga undantag som genereras genom att försöka skapa dataströmmen.

Returvärde

Nonzero om strömmen har skapats. annars 0.

Anmärkningar

Minnet allokeras av OLE-undersystemet.

Mer information finns i CreateStreamOnHGlobal i Windows SDK.

COleStreamFile::CreateStream

Skapar på ett säkert sätt en ny ström i det angivna lagringsobjektet där ett fel är ett normalt, förväntat villkor.

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

Parametrar

lpStorage
Pekar på OLE-lagringsobjektet som innehåller dataströmmen som ska skapas. Det går inte att vara NULL.

lpszStreamName
Namnet på strömmen som ska skapas. Det går inte att vara NULL.

nOpenFlags
Åtkomstläge som ska användas när strömmen öppnas. Exklusiva lägen för läsning/skrivning och skapande används som standard. En fullständig lista över tillgängliga lägen finns i CFile::CFile.

pError
Pekar på ett CFileException--objekt eller NULL. Ange den här parametern om du vill övervaka möjliga undantag som genereras genom att försöka skapa dataströmmen.

Returvärde

Nonzero om strömmen har skapats. annars 0.

Anmärkningar

Ett filundantag utlöses om det inte går att öppna och pError inte är NULL.

Mer information finns i IStorage::CreateStream i Windows SDK.

COleStreamFile::D etach

Kopplar bort strömmen från objektet utan att stänga strömmen.

LPSTREAM Detach();

Returvärde

En pekare till strömmen (IStream) som var associerad med objektet.

Anmärkningar

Strömmen måste stängas på något annat sätt innan programmet avslutas.

Mer information finns i IStream i Windows SDK.

COleStreamFile::GetStream

Anropa den här funktionen för att returnera en pekare till aktuell ström.

IStream* GetStream() const;

Returvärde

En pekare till det aktuella strömgränssnittet ( IStream).

COleStreamFile::OpenStream

Öppnar en befintlig ström.

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

Parametrar

lpStorage
Pekar på OLE-lagringsobjektet som innehåller dataströmmen som ska öppnas. Det går inte att vara NULL.

lpszStreamName
Namnet på strömmen som ska öppnas. Det går inte att vara NULL.

nOpenFlags
Åtkomstläge som ska användas när strömmen öppnas. Exklusiva lägen och läs-/skrivlägen används som standard. En fullständig lista över tillgängliga lägen finns i CFile::CFile.

pError
Pekar på ett CFileException--objekt eller NULL. Ange den här parametern om du vill övervaka möjliga undantag som genereras genom att försöka öppna dataströmmen.

Returvärde

Nonzero om strömmen har öppnats. annars 0.

Anmärkningar

Ett filundantag utlöses om det inte går att öppna och pError inte är NULL.

Mer information finns i IStorage::OpenStream i Windows SDK.

Se även

CFile-klass
hierarkidiagram