COleStreamFile Sınıfı

OLE Yapılandırılmış Depolama'nın parçası olarak bileşik bir dosyadaki veri akışını (IStream) temsil eder.

Sözdizimi

class COleStreamFile : public CFile

Üyeler

Ortak Oluşturucular

Veri Akışı Adı	Açıklama
COleStreamFile::COleStreamFile	Bir COleStreamFile nesne oluşturur.

Genel Yöntemler

Veri Akışı Adı	Açıklama
COleStreamFile::Attach	Bir akışı nesnesiyle ilişkilendirir.
COleStreamFile::CreateMemoryStream	Genel bellekten bir akış oluşturur ve bunu nesnesiyle ilişkilendirir.
COleStreamFile::CreateStream	Bir akış oluşturur ve bunu nesnesiyle ilişkilendirir.
COleStreamFile::D etach	Akışı nesneden ayırır.
COleStreamFile::GetStream	Geçerli akışı döndürür.
COleStreamFile::OpenStream	Bir akışı güvenli bir şekilde açar ve nesnesiyle ilişkilendirir.

Açıklamalar

Bir IStorage bellek akışı olmadığı sürece akışın açılabilmesi veya oluşturulabilmesi için önce bir nesnenin mevcut olması gerekir.

COleStreamFilenesneleri tam olarak CFile nesneleri gibi değiştirilir.

Akışları ve depolamaları düzenleme hakkında daha fazla bilgi için Kapsayıcılar: Bileşik Dosyalar..

Daha fazla bilgi için bkz . Windows SDK'sında IStream ve IStorage .

Devralma Hiyerarşisi

CObject

CFile

COleStreamFile

Gereksinimler

Üst bilgi: afxole.h

COleStreamFile::Attach

Sağlanan OLE akışını nesnesiyle ilişkilendirir COleStreamFile .

void Attach(LPSTREAM lpStream);

Parametreler

lpStream
Nesneyle ilişkilendirilecek OLE akışını (IStream) gösterir. NULL olamaz.

Açıklamalar

Nesne zaten bir OLE akışıyla ilişkilendirilmemiş olmalıdır.

Daha fazla bilgi için bkz . Windows SDK'sında IStream .

COleStreamFile::COleStreamFile

Bir COleStreamFile nesnesi oluşturur.

COleStreamFile(LPSTREAM lpStream = NULL);

Parametreler

lpStream
Nesneyle ilişkilendirilecek OLE akışının işaretçisi.

Açıklamalar

lpStream NULL ise nesne bir OLE akışıyla ilişkilendirilmemiştir, aksi takdirde nesne sağlanan OLE akışıyla ilişkilendirilir.

Daha fazla bilgi için bkz . Windows SDK'sında IStream .

COleStreamFile::CreateMemoryStream

Bir hatanın normal, beklenen bir koşul olduğu genel, paylaşılan bellek dışında güvenli bir şekilde yeni bir akış oluşturur.

BOOL CreateMemoryStream(CFileException* pError = NULL);

Parametreler

pError
Oluşturma işleminin tamamlanma durumunu gösteren bir CFileException nesnesine veya NULL'a işaret eder. Akışı oluşturmaya çalışarak oluşturulan olası özel durumları izlemek istiyorsanız bu parametreyi sağlayın.

Dönüş Değeri

Akış başarıyla oluşturulursa sıfır olmayan; aksi takdirde 0.

Açıklamalar

Bellek OLE alt sistemi tarafından ayrılır.

Daha fazla bilgi için bkz . Windows SDK'sında CreateStreamOnHGlobal .

COleStreamFile::CreateStream

Bir hatanın normal, beklenen bir koşul olduğu sağlanan depolama nesnesinde güvenli bir şekilde yeni bir akış oluşturur.

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

Parametreler

lpStorage
Oluşturulacak akışı içeren OLE depolama nesnesini gösterir. NULL olamaz.

lpszStreamName
Oluşturulacak akışın adı. NULL olamaz.

nOpenFlags
Akışı açarken kullanılacak erişim modu. Özel kullanım, okuma/yazma ve oluşturma modları varsayılan olarak kullanılır. Kullanılabilir modların tam listesi için bkz . CFile::CFile.

pError
Bir CFileException nesnesine veya NULL'a işaret edin. Akışı oluşturmaya çalışarak oluşturulan olası özel durumları izlemek istiyorsanız bu parametreyi sağlayın.

Dönüş Değeri

Akış başarıyla oluşturulursa sıfır olmayan; aksi takdirde 0.

Açıklamalar

Açma başarısız olursa ve pError NULL değilse bir dosya özel durumu oluşturulur.

Daha fazla bilgi için bkz . Windows SDK'sında IStorage::CreateStream .

COleStreamFile::D etach

Akışı kapatmadan nesneden akışı ayırır.

LPSTREAM Detach();

Dönüş Değeri

Nesneyle ilişkilendirilmiş akışın (IStream) işaretçisi.

Açıklamalar

Program sonlandırılmadan önce akışın başka bir şekilde kapatılması gerekir.

Daha fazla bilgi için bkz . Windows SDK'sında IStream .

COleStreamFile::GetStream

Geçerli akışa bir işaretçi döndürmek için bu işlevi çağır.

IStream* GetStream() const;

Dönüş Değeri

Geçerli akış arabirimine ( IStream) ilişkin bir işaretçi.

COleStreamFile::OpenStream

Mevcut bir akışı açar.

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

Parametreler

lpStorage
Açılacak akışı içeren OLE depolama nesnesini gösterir. NULL olamaz.

lpszStreamName
Açılacak akışın adı. NULL olamaz.

nOpenFlags
Akışı açarken kullanılacak erişim modu. Özel kullanım ve okuma/yazma modları varsayılan olarak kullanılır. Kullanılabilir modların tam listesi için bkz . CFile::CFile.

pError
Bir CFileException nesnesine veya NULL'a işaret edin. Akışı açmaya çalışarak oluşturulan olası özel durumları izlemek istiyorsanız bu parametreyi sağlayın.

Dönüş Değeri

Akış başarıyla açılırsa sıfır olmayan; aksi takdirde 0.

Açıklamalar

Açma başarısız olursa ve pError NULL değilse bir dosya özel durumu oluşturulur.

Daha fazla bilgi için bkz . Windows SDK'sında IStorage::OpenStream .

Ayrıca bkz.

CFile Sınıfı
Hiyerarşi Grafiği