Kelas CMonikerFile
Mewakili aliran data ( IStream) yang dinamai oleh IMoniker.
Sintaks
class CMonikerFile : public COleStreamFile
Anggota
Konstruktor Publik
Nama | Deskripsi |
---|---|
CMonikerFile::CMonikerFile | Membuat CMonikerFile objek. |
Metode Publik
Nama | Deskripsi |
---|---|
CMonikerFile::Close | Melepaskan dan merilis aliran dan merilis moniker. |
CMonikerFile::D etach | Mencopot IMoniker dari objek ini CMonikerFile . |
CMonikerFile::GetMoniker | Mengembalikan moniker saat ini. |
CMonikerFile::Open | Membuka file yang ditentukan untuk mendapatkan aliran. |
Metode yang Dilindungi
Nama | Deskripsi |
---|---|
CMonikerFile::CreateBindContext | Mendapatkan konteks pengikatan atau membuat konteks ikatan yang diinisialisasi default. |
Keterangan
Moniker berisi informasi seperti nama jalur ke file. Jika Anda memiliki penunjuk ke antarmuka objek IMoniker
moniker, Anda bisa mendapatkan akses ke file yang diidentifikasi tanpa memiliki informasi spesifik lainnya tentang di mana file tersebut sebenarnya berada.
Berasal dari COleStreamFile
, CMonikerFile
mengambil moniker atau representasi string yang dapat dibuat menjadi moniker dan mengikat ke aliran di mana moniker adalah nama. Anda kemudian dapat membaca dan menulis ke aliran tersebut. Tujuan CMonikerFile
sebenarnya adalah untuk menyediakan akses sederhana ke IStream
s yang dinamai oleh IMoniker
s sehingga Anda tidak perlu mengikat aliran sendiri, namun memiliki CFile
fungsionalitas ke aliran.
CMonikerFile
tidak dapat digunakan untuk mengikat apa pun selain aliran. Jika Anda ingin mengikat ke penyimpanan atau objek, Anda harus menggunakan antarmuka secara IMoniker
langsung.
Untuk informasi selengkapnya tentang aliran dan moniker, lihat COleStreamFile di Referensi MFC dan IStream dan IMoniker di Windows SDK.
Hierarki Warisan
CMonikerFile
Persyaratan
Header: afxole.h
CMonikerFile::Close
Panggil fungsi ini untuk melepaskan dan merilis aliran dan untuk merilis moniker.
virtual void Close();
Keterangan
Dapat dipanggil pada aliran yang belum dibuka atau sudah ditutup.
CMonikerFile::CMonikerFile
Membuat CMonikerFile
objek.
CMonikerFile();
CMonikerFile::CreateBindContext
Panggil fungsi ini untuk membuat konteks ikatan yang diinisialisasi default.
IBindCtx* CreateBindContext(CFileException* pError);
Parameter
pError
Penunjuk ke pengecualian file. Jika terjadi kesalahan, kesalahan akan diatur ke penyebabnya.
Tampilkan Nilai
Penunjuk ke konteks ikatan IBindCtx untuk diikat dengan jika berhasil; jika tidak, NULL. Jika instans dibuka dengan IBindHost
antarmuka, konteks pengikatan diambil dari IBindHost
. Jika tidak IBindHost
ada antarmuka atau antarmuka gagal mengembalikan konteks pengikatan, konteks ikatan akan dibuat. Untuk deskripsi antarmuka IBindHost , lihat Windows SDK.
Keterangan
Konteks ikatan adalah objek yang menyimpan informasi tentang operasi pengikatan moniker tertentu. Anda dapat mengambil alih fungsi ini untuk menyediakan konteks pengikatan kustom.
CMonikerFile::D etach
Panggil fungsi ini untuk menutup aliran.
BOOL Detach(CFileException* pError = NULL);
Parameter
pError
Penunjuk ke pengecualian file. Jika terjadi kesalahan, kesalahan akan diatur ke penyebabnya.
Tampilkan Nilai
Bukan nol jika berhasil; jika tidak, 0.
CMonikerFile::GetMoniker
Panggil fungsi ini untuk mengambil penunjuk ke moniker saat ini.
IMoniker* GetMoniker() const;
Tampilkan Nilai
Penunjuk ke antarmuka moniker saat ini ( IMoniker).
Keterangan
Karena CMonikerFile
bukan antarmuka, penunjuk yang dikembalikan tidak menambah jumlah referensi (melalui AddRef), dan moniker dirilis saat CMonikerFile
objek dirilis. Jika Anda ingin memegang moniker atau melepaskannya sendiri, Anda harus AddRef
itu.
CMonikerFile::Open
Panggil fungsi anggota ini untuk membuka file atau objek moniker.
virtual BOOL Open(
LPCTSTR lpszURL,
CFileException* pError = NULL);
virtual BOOL Open(
IMoniker* pMoniker,
CFileException* pError = NULL);
Parameter
lpszURL
URL atau nama file file yang akan dibuka.
pError
Penunjuk ke pengecualian file. Jika terjadi kesalahan, kesalahan akan diatur ke penyebabnya.
pMoniker
Penunjuk ke antarmuka IMoniker
moniker yang akan digunakan untuk mendapatkan aliran.
Tampilkan Nilai
Bukan nol jika berhasil; jika tidak, 0.
Keterangan
Parameter lpszURL tidak dapat digunakan pada Macintosh. Hanya bentuk pMoniker yang Open
dapat digunakan pada Macintosh.
Anda dapat menggunakan URL atau nama file untuk parameter lpszURL . Contohnya:
CMyMoniker* pMyMoniker = new CMyMoniker();
pMyMoniker->Open(_T("http://www.microsoft.com"));
- atau -
CMyMoniker* pMyMoniker = new CMyMoniker();
pMyMoniker->Open(_T("file:c:\\mydata.dat"));