CMonikerFile – třída

Představuje datový proud ( IStream) pojmenovaný objektem IMoniker.

Syntaxe

class CMonikerFile : public COleStreamFile

Členové

Veřejné konstruktory

Název	Popis
CMonikerFile::CMonikerFile	CMonikerFile Vytvoří objekt.

Veřejné metody

Název	Popis
CMonikerFile::Close	Odpojte a uvolní stream a uvolní moniker.
CMonikerFile::D etach	Odpojte objekt od tohoto CMonikerFile objektuIMoniker.
CMonikerFile::GetMoniker	Vrátí aktuální moniker.
CMonikerFile::Open	Otevře zadaný soubor pro získání datového proudu.

Chráněné metody

Název	Popis
CMonikerFile::CreateBindContext	Získá kontext vazby nebo vytvoří výchozí inicializovaný kontext vazby.

Poznámky

Moniker obsahuje informace podobně jako název cesty k souboru. Pokud máte ukazatel na rozhraní objektu IMoniker monikeru, můžete získat přístup k identifikovanému souboru bez jakýchkoli dalších konkrétních informací o tom, kde se soubor skutečně nachází.

Odvozeno od COleStreamFile, CMonikerFile vezme moniker nebo řetězcové vyjádření, které může vytvořit do monikeru a vytvoří vazbu na datový proud, pro který je moniker název. Pak můžete číst a zapisovat do daného datového proudu. Skutečným účelem CMonikerFile je poskytnout jednoduchý přístup k IStreampojmenovaným s IMoniker, takže nemusíte svázat s datovým proudem sami, ale mít CFile funkce streamu.

CMonikerFile nelze použít k vytvoření vazby k ničemu jinému než datovému proudu. Pokud chcete vytvořit vazbu k úložišti nebo objektu, musíte rozhraní použít IMoniker přímo.

Další informace o datových proudech a monikers naleznete v souboru COleStreamFile v odkazech MFC a IStream a IMoniker v sadě Windows SDK.

Hierarchie dědičnosti

Objekt CObject

CFile

COleStreamFile

CMonikerFile

Požadavky

Hlavička: afxole.h

CMonikerFile::Close

Voláním této funkce odpojení a uvolněním streamu a uvolněním monikeru.

virtual void Close();

Poznámky

Lze volat u neotevřených nebo již uzavřených datových proudů.

CMonikerFile::CMonikerFile

CMonikerFile Vytvoří objekt.

CMonikerFile();

CMonikerFile::CreateBindContext

Voláním této funkce vytvoříte výchozí inicializovaný kontext vazby.

IBindCtx* CreateBindContext(CFileException* pError);

Parametry

Chyba pError
Ukazatel na výjimku souboru. V případě chyby se nastaví na příčinu.

Návratová hodnota

Ukazatel na kontext vazby IBindCtx pro vytvoření vazby v případě úspěchu; jinak NULL. Pokud byla instance otevřena pomocí IBindHost rozhraní, kontext vazby se načte z objektu IBindHost. Pokud neexistuje žádné IBindHost rozhraní nebo rozhraní nevrátí kontext vazby, vytvoří se kontext vazby. Popis rozhraní IBindHost naleznete v sadě Windows SDK.

Poznámky

Kontext vazby je objekt, který ukládá informace o konkrétní operaci vazby monikeru. Tuto funkci můžete přepsat tak, aby poskytovala vlastní kontext vazby.

CMonikerFile::D etach

Voláním této funkce zavřete stream.

BOOL Detach(CFileException* pError = NULL);

Parametry

Chyba pError
Ukazatel na výjimku souboru. V případě chyby se nastaví na příčinu.

Návratová hodnota

Nenulové, pokud je úspěšné; jinak 0.

CMonikerFile::GetMoniker

Voláním této funkce načtěte ukazatel na aktuální moniker.

IMoniker* GetMoniker() const;

Návratová hodnota

Ukazatel na aktuální rozhraní monikeru ( IMoniker).

Poznámky

Vzhledem k tomu CMonikerFile , že není rozhraní, ukazatel vrácený nezvýšuje počet odkazů (prostřednictvím AddRef) a moniker je uvolněn při uvolnění objektu CMonikerFile . Pokud se chcete držet pod monikerem nebo ho uvolnit sami, musíte AddRef to udělat.

CMonikerFile::Open

Voláním této členské funkce otevřete soubor nebo objekt monikeru.

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

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

Parametry

lpszURL
Adresa URL nebo název souboru, který se má otevřít.

Chyba pError
Ukazatel na výjimku souboru. V případě chyby se nastaví na příčinu.

pMoniker
Ukazatel na rozhraní IMoniker monikeru, které se má použít k získání datového proudu.

Návratová hodnota

Nenulové, pokud je úspěšné; jinak 0.

Poznámky

Parametr lpszURL nelze použít v systému Macintosh. V systému Macintosh lze použít pouze pMonikerovou Open formu.

Pro parametr lpszURL můžete použít adresu URL nebo název souboru. Příklad:

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

- nebo -

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

Viz také

COleStreamFile – třída
Graf hierarchie
CAsyncMonikerFile – třída