CMonikerFile Sınıfı

Bir IMoniker tarafından adlandırılan veri akışını (IStream) temsil eder.

Sözdizimi

class CMonikerFile : public COleStreamFile

Üyeler

Ortak Oluşturucular

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

Genel Yöntemler

Veri Akışı Adı	Açıklama
CMonikerFile::Close	Akışı ayırır ve serbest bırakır ve takma adını serbest bırakır.
CMonikerFile::D etach	öğesini bu CMonikerFile nesneden ayırırIMoniker.
CMonikerFile::GetMoniker	Geçerli takma adı döndürür.
CMonikerFile::Open	Akış almak için belirtilen dosyayı açar.

Korumalı Yöntemler

Veri Akışı Adı	Açıklama
CMonikerFile::CreateBindContext	Bağlama bağlamını alır veya varsayılan olarak başlatılan bağlama bağlamı oluşturur.

Açıklamalar

Bir ad, dosyanın yol adına çok benzer bilgiler içerir. Bir takma adı nesnesinin IMoniker arabirimine ilişkin bir işaretçiniz varsa, dosyanın gerçekte bulunduğu yer hakkında başka belirli bilgilere sahip olmadan tanımlanan dosyaya erişebilirsiniz.

'den COleStreamFileCMonikerFile türetilen, bir takma ad veya bir ad olarak oluşturabileceği bir dize gösterimi alır ve takma adın bir ad olduğu akışa bağlanır. Daha sonra bu akışı okuyabilir ve yazabilirsiniz. Gerçek amacıCMonikerFile, bir akışa IStreamkendiniz bağlanmak zorunda değil, ancak CFile akışa işlevsellik sağlamak için tarafından adlandırılmışlara IMonikerbasit erişim sağlamaktır.

CMonikerFile akış dışında bir şeye bağlanmak için kullanılamaz. Depolamaya veya nesneye bağlanmak istiyorsanız arabirimini doğrudan kullanmanız IMoniker gerekir.

Akışlar ve takma adlar hakkında daha fazla bilgi için bkz. Windows SDK'sında MFC Başvurusu ve IStream ve IMoniker'deki COleStreamFile.

Devralma Hiyerarşisi

CObject

CFile

COleStreamFile

CMonikerFile

Gereksinimler

Üst bilgi: afxole.h

CMonikerFile::Close

Akışı ayırmak ve serbest bırakmak ve takma adı serbest bırakmak için bu işlevi çağırın.

virtual void Close();

Açıklamalar

Açılmamış veya zaten kapalı akışlarda çağrılabilir.

CMonikerFile::CMonikerFile

Bir CMonikerFile nesne oluşturur.

CMonikerFile();

CMonikerFile::CreateBindContext

Varsayılan olarak başlatılan bağlama bağlamı oluşturmak için bu işlevi çağır.

IBindCtx* CreateBindContext(CFileException* pError);

Parametreler

pError
Dosya özel durumunun işaretçisi. Hata durumunda, neden olarak ayarlanır.

Dönüş Değeri

Başarılı olursa bağlanacak bağlama bağlamı IBindCtx işaretçisi; aksi takdirde NULL. Örnek bir IBindHost arabirimle açıldıysa bağlama bağlamı içinden IBindHostalınır. Arabirim yoksa IBindHost veya arabirim bağlama bağlamı döndüremezse bağlama bağlamı oluşturulur. IBindHost arabiriminin açıklaması için bkz. Windows SDK'sı.

Açıklamalar

Bağlama bağlamı, belirli bir takma ad bağlama işlemi hakkındaki bilgileri depolayan bir nesnedir. Özel bağlama bağlamı sağlamak için bu işlevi geçersiz kılabilirsiniz.

CMonikerFile::D etach

Akışı kapatmak için bu işlevi çağırın.

BOOL Detach(CFileException* pError = NULL);

Parametreler

pError
Dosya özel durumunun işaretçisi. Hata durumunda, neden olarak ayarlanır.

Dönüş Değeri

Başarılı olursa sıfır olmayan; aksi takdirde 0.

CMonikerFile::GetMoniker

Geçerli takma adın işaretçisini almak için bu işlevi çağırın.

IMoniker* GetMoniker() const;

Dönüş Değeri

Geçerli ad arabirimine ( IMoniker) ilişkin bir işaretçi.

Açıklamalar

Arabirim CMonikerFile olmadığından, döndürülen işaretçi başvuru sayısını artırmaz (AddRef aracılığıyla) ve nesne serbest bırakıldığında CMonikerFile takma ad serbest bırakılır. Eğer takma adı tutmak veya kendiniz serbest bırakmak istiyorsanız, bunu yapmak gerekir AddRef .

CMonikerFile::Open

Bu üye işlevini çağırarak bir dosya veya takma ad nesnesi açın.

virtual BOOL Open(
    LPCTSTR lpszURL,
    CFileException* pError = NULL);

virtual BOOL Open(
    IMoniker* pMoniker,
    CFileException* pError = NULL);

Parametreler

lpszURL
Açılacak dosyanın URL'si veya dosya adı.

pError
Dosya özel durumunun işaretçisi. Hata durumunda, neden olarak ayarlanır.

pMoniker
Bir akış elde etmek için kullanılacak bilinen arabirim IMoniker işaretçisi.

Dönüş Değeri

Başarılı olursa sıfır olmayan; aksi takdirde 0.

Açıklamalar

LpszURL parametresi Macintosh üzerinde kullanılamaz. Macintosh üzerinde yalnızca pMonik biçimi Open kullanılabilir.

lpszURL parametresi için URL veya dosya adı kullanabilirsiniz. Örneğin:

CMyMoniker* pMyMoniker = new CMyMoniker();
pMyMoniker->Open(_T("http://www.microsoft.com"));

- veya -

CMyMoniker* pMyMoniker = new CMyMoniker();
pMyMoniker->Open(_T("file:c:\\mydata.dat"));

Ayrıca bkz.

COleStreamFile Sınıfı
Hiyerarşi Grafiği
CAsyncMonikerFile Sınıfı