Klasa CMonikerFile

Reprezentuje strumień danych ( IStream) o nazwie IMoniker.

Składnia

class CMonikerFile : public COleStreamFile

Elementy członkowskie

Konstruktory publiczne

Nazwa/nazwisko	opis
CMonikerFile::CMonikerFile	CMonikerFile Tworzy obiekt.

Metody publiczne

Nazwa/nazwisko	opis
CMonikerFile::Close	Odłącza i zwalnia strumień i zwalnia pseudonim.
CMonikerFile::D etach	Odłącza obiekt IMoniker od tego CMonikerFile obiektu.
CMonikerFile::GetMoniker	Zwraca bieżący moniker.
CMonikerFile::Open	Otwiera określony plik w celu uzyskania strumienia.

Metody chronione

Nazwa/nazwisko	opis
CMonikerFile::CreateBindContext	Uzyskuje kontekst powiązania lub tworzy domyślny zainicjowany kontekst powiązania.

Uwagi

Moniker zawiera informacje podobne do nazwy ścieżki do pliku. Jeśli masz wskaźnik do interfejsu obiektu IMoniker moniker, możesz uzyskać dostęp do zidentyfikowanego pliku bez konieczności posiadania innych szczegółowych informacji o tym, gdzie rzeczywiście znajduje się plik.

Pochodzi z COleStreamFileklasy , CMonikerFile przyjmuje nazwę lub reprezentację ciągu, którą może utworzyć w moniker i powiązać ze strumieniem, dla którego moniker jest nazwą. Następnie możesz odczytywać i zapisywać w tym strumieniu. Rzeczywistym celem jest zapewnienie prostego CMonikerFile dostępu do IStreamnazwanych przez IMonikers, aby nie trzeba było wiązać się ze strumieniem, ale mieć CFile funkcjonalność strumienia.

CMonikerFile Nie można użyć do powiązania z niczym innym niż strumień. Jeśli chcesz powiązać z magazynem lub obiektem, musisz użyć interfejsu IMoniker bezpośrednio.

Aby uzyskać więcej informacji na temat strumieni i monikers, zobacz COleStreamFile w dokumentacji MFC i IStream i IMoniker w zestawie Windows SDK.

Hierarchia dziedziczenia

Obiekt CObject

CFile

COleStreamFile

CMonikerFile

Wymagania

Nagłówek: afxole.h

CMonikerFile::Close

Wywołaj tę funkcję, aby odłączyć i zwolnić strumień oraz zwolnić moniker.

virtual void Close();

Uwagi

Można wywołać przy nieotwartych lub już zamkniętych strumieniach.

CMonikerFile::CMonikerFile

CMonikerFile Tworzy obiekt.

CMonikerFile();

CMonikerFile::CreateBindContext

Wywołaj tę funkcję, aby utworzyć domyślny zainicjowany kontekst powiązania.

IBindCtx* CreateBindContext(CFileException* pError);

Parametry

pError
Wskaźnik do wyjątku pliku. W przypadku błędu zostanie on ustawiony na przyczynę.

Wartość zwracana

Wskaźnik do kontekstu powiązania IBindCtx , aby powiązać z, jeśli się powiedzie, w przeciwnym razie wartość NULL. Jeśli wystąpienie zostało otwarte za pomocą interfejsu IBindHost , kontekst powiązania zostanie pobrany z pliku IBindHost. Jeśli nie IBindHost ma interfejsu lub interfejs nie zwróci kontekstu powiązania, zostanie utworzony kontekst powiązania. Aby uzyskać opis interfejsu IBindHost , zobacz zestaw Windows SDK.

Uwagi

Kontekst powiązania to obiekt, który przechowuje informacje o określonej operacji powiązania moniker. Tę funkcję można zastąpić, aby zapewnić niestandardowy kontekst powiązania.

CMonikerFile::D etach

Wywołaj tę funkcję, aby zamknąć strumień.

BOOL Detach(CFileException* pError = NULL);

Parametry

pError
Wskaźnik do wyjątku pliku. W przypadku błędu zostanie on ustawiony na przyczynę.

Wartość zwracana

Bezzerowe, jeśli się powiedzie; w przeciwnym razie 0.

CMonikerFile::GetMoniker

Wywołaj tę funkcję, aby pobrać wskaźnik do bieżącego monikera.

IMoniker* GetMoniker() const;

Wartość zwracana

Wskaźnik do bieżącego interfejsu moniker ( IMoniker).

Uwagi

Ponieważ CMonikerFile nie jest interfejsem, wskaźnik zwrócony nie zwiększa liczby odwołań (za pośrednictwem dodatku AddRef), a moniker jest zwalniany po wydaniu CMonikerFile obiektu. Jeśli chcesz trzymać się pseudonimu lub zwolnić go samodzielnie, musisz AddRef go.

CMonikerFile::Open

Wywołaj tę funkcję składową, aby otworzyć plik lub obiekt moniker.

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

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

Parametry

lpszURL
Adres URL lub nazwa pliku do otwarcia.

pError
Wskaźnik do wyjątku pliku. W przypadku błędu zostanie on ustawiony na przyczynę.

pMoniker
Wskaźnik do interfejsu IMoniker moniker, który ma być używany do uzyskiwania strumienia.

Wartość zwracana

Bezzerowe, jeśli się powiedzie; w przeciwnym razie 0.

Uwagi

Nie można użyć parametru lpszURL na komputerze Macintosh. Na komputerze Macintosh można używać tylko formy Open pMoniker.

Możesz użyć adresu URL lub nazwy pliku dla parametru lpszURL . Na przykład:

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

- lub -

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

Zobacz też

Klasa COleStreamFile
Wykres hierarchii
Klasa CAsyncMonikerFile