Bagikan melalui

Kelas COleStreamFile

  • Artikel

Mewakili aliran data (IStream) dalam file gabungan sebagai bagian dari OLE Structured Storage.

Sintaks

class COleStreamFile : public CFile

Anggota

Konstruktor Publik

Nama Deskripsi
COleStreamFile::COleStreamFile Membuat COleStreamFile objek.

Metode Publik

Nama Deskripsi
COleStreamFile::Lampirkan Mengaitkan aliran dengan objek .
COleStreamFile::CreateMemoryStream Membuat aliran dari memori global dan mengaitkannya dengan objek .
COleStreamFile::CreateStream Membuat aliran dan mengaitkannya dengan objek .
COleStreamFile::D etach Memisahkan aliran dari objek.
COleStreamFile::GetStream Mengembalikan aliran saat ini.
COleStreamFile::OpenStream Membuka aliran dengan aman dan mengaitkannya dengan objek .

Keterangan

Objek IStorage harus ada sebelum aliran dapat dibuka atau dibuat kecuali itu adalah aliran memori.

COleStreamFile objek dimanipulasi persis seperti objek CFile .

Untuk informasi selengkapnya tentang memanipulasi aliran dan penyimpanan, lihat artikel Kontainer: File Gabungan.

Untuk informasi selengkapnya, lihat IStream dan IStorage di Windows SDK.

Hierarki Warisan

CObject

CFile

COleStreamFile

Persyaratan

Header: afxole.h

COleStreamFile::Lampirkan

Mengaitkan aliran OLE yang disediakan dengan COleStreamFile objek .

void Attach(LPSTREAM lpStream);

Parameter

lpStream
Menunjuk ke aliran OLE (IStream) yang akan dikaitkan dengan objek. Tidak boleh NULL.

Keterangan

Objek belum boleh dikaitkan dengan aliran OLE.

Untuk informasi selengkapnya, lihat IStream di Windows SDK.

COleStreamFile::COleStreamFile

COleStreamFile Membuat objek.

COleStreamFile(LPSTREAM lpStream = NULL);

Parameter

lpStream
Penunjuk ke aliran OLE yang akan dikaitkan dengan objek.

Keterangan

Jika lpStream NULL, objek tidak terkait dengan aliran OLE, jika tidak, objek dikaitkan dengan aliran OLE yang disediakan.

Untuk informasi selengkapnya, lihat IStream di Windows SDK.

COleStreamFile::CreateMemoryStream

Dengan aman menciptakan aliran baru keluar dari memori bersama global di mana kegagalan adalah kondisi normal dan diharapkan.

BOOL CreateMemoryStream(CFileException* pError = NULL);

Parameter

pError
Menunjuk ke objek CFileException atau NULL yang menunjukkan status penyelesaian operasi buat. Berikan parameter ini jika Anda ingin memantau kemungkinan pengecualian yang dihasilkan dengan mencoba membuat aliran.

Tampilkan Nilai

Bukan nol jika aliran berhasil dibuat; jika tidak, 0.

Keterangan

Memori dialokasikan oleh subsistem OLE.

Untuk informasi selengkapnya, lihat CreateStreamOnHGlobal di Windows SDK.

COleStreamFile::CreateStream

Membuat aliran baru dengan aman di objek penyimpanan yang disediakan di mana kegagalan adalah kondisi normal yang diharapkan.

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

Parameter

lpStorage
Arahkan ke objek penyimpanan OLE yang berisi aliran yang akan dibuat. Tidak boleh NULL.

lpszStreamName
Nama aliran yang akan dibuat. Tidak boleh NULL.

nOpenFlags
Mode akses yang akan digunakan saat membuka aliran. Mode eksklusif, baca/tulis, dan buat digunakan secara default. Untuk daftar lengkap mode yang tersedia, lihat CFile::CFile.

pError
Menunjuk ke objek CFileException atau NULL. Berikan parameter ini jika Anda ingin memantau kemungkinan pengecualian yang dihasilkan dengan mencoba membuat aliran.

Tampilkan Nilai

Bukan nol jika aliran berhasil dibuat; jika tidak, 0.

Keterangan

Pengecualian file akan dilemparkan jika terbuka gagal dan pError bukan NULL.

Untuk informasi selengkapnya, lihat IStorage::CreateStream di Windows SDK.

COleStreamFile::D etach

Memisahkan aliran dari objek tanpa menutup aliran.

LPSTREAM Detach();

Tampilkan Nilai

Penunjuk ke aliran (IStream) yang terkait dengan objek.

Keterangan

Aliran harus ditutup dengan beberapa cara lain sebelum program berakhir.

Untuk informasi selengkapnya, lihat IStream di Windows SDK.

COleStreamFile::GetStream

Panggil fungsi ini untuk mengembalikan penunjuk ke aliran saat ini.

IStream* GetStream() const;

Tampilkan Nilai

Penunjuk ke antarmuka aliran saat ini ( IStream).

COleStreamFile::OpenStream

Membuka aliran yang ada.

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

Parameter

lpStorage
Arahkan ke objek penyimpanan OLE yang berisi aliran yang akan dibuka. Tidak boleh NULL.

lpszStreamName
Nama aliran yang akan dibuka. Tidak boleh NULL.

nOpenFlags
Mode akses yang akan digunakan saat membuka aliran. Mode eksklusif dan baca/tulis digunakan secara default. Untuk daftar lengkap mode yang tersedia, lihat CFile::CFile.

pError
Menunjuk ke objek CFileException atau NULL. Berikan parameter ini jika Anda ingin memantau kemungkinan pengecualian yang dihasilkan dengan mencoba membuka aliran.

Tampilkan Nilai

Bukan nol jika aliran berhasil dibuka; jika tidak, 0.

Keterangan

Pengecualian file akan dilemparkan jika terbuka gagal dan pError bukan NULL.

Untuk informasi selengkapnya, lihat IStorage::OpenStream di Windows SDK.

Lihat juga

Kelas CFile
Bagan Hierarki