CMonikerFile-Klasse

  • Artikel

Stellt einen Datenstrom ( IStream) dar, der von einem IMoniker benannt wird.

Syntax

class CMonikerFile : public COleStreamFile

Member

Öffentliche Konstruktoren

Name Beschreibung
CMonikerFile::CMonikerFile Erstellt ein CMonikerFile-Objekt.

Öffentliche Methoden

Name Beschreibung
CMonikerFile::Close Löst den Stream ab und gibt den Moniker frei.
CMonikerFile::D etach Trennt das IMoniker Objekt von diesem CMonikerFile Objekt.
CMonikerFile::GetMoniker Gibt den aktuellen Moniker zurück.
CMonikerFile::Open Öffnet die angegebene Datei, um einen Datenstrom abzurufen.

Geschützte Methoden

Name Beschreibung
CMonikerFile::CreateBindContext Ruft den Bindungskontext ab oder erstellt einen standardmäßigen initialisierten Bindungskontext.

Hinweise

Ein Moniker enthält Informationen ähnlich wie ein Pfadname zu einer Datei. Wenn Sie über einen Zeiger auf die Schnittstelle eines Moniker-Objekts IMoniker verfügen, können Sie Zugriff auf die identifizierte Datei erhalten, ohne andere spezifische Informationen darüber zu erhalten, wo sich die Datei tatsächlich befindet.

Abgeleitet von COleStreamFile, CMonikerFile nimmt einen Moniker oder eine Zeichenfolgendarstellung, die er zu einem Moniker machen kann und bindet an den Datenstrom, für den der Moniker ein Name ist. Anschließend können Sie diesen Datenstrom lesen und schreiben. Der eigentliche Zweck CMonikerFile besteht darin, einfachen Zugriff auf s namens IMonikers zu IStreamermöglichen, damit Sie nicht selbst an einen Datenstrom binden müssen, aber über Funktionen für den Datenstrom verfügenCFile.

CMonikerFile Kann nicht verwendet werden, um eine Bindung an einen anderen Datenstrom als einen Datenstrom zu erstellen. Wenn Sie eine Bindung an den Speicher oder ein Objekt herstellen möchten, müssen Sie die IMoniker Schnittstelle direkt verwenden.

Weitere Informationen zu Streams und Monikern finden Sie unter COleStreamFile in der MFC Reference und IStream und IMoniker im Windows SDK.

Vererbungshierarchie

CObject

CFile

COleStreamFile

CMonikerFile

Anforderungen

Kopfzeile: afxole.h

CMonikerFile::Close

Rufen Sie diese Funktion auf, um den Datenstrom zu trennen und freizugeben und den Moniker freizugeben.

virtual void Close();

Hinweise

Kann für ungeöffnete oder bereits geschlossene Datenströme aufgerufen werden.

CMonikerFile::CMonikerFile

Erstellt ein CMonikerFile-Objekt.

CMonikerFile();

CMonikerFile::CreateBindContext

Rufen Sie diese Funktion auf, um einen standardmäßigen initialisierten Bindungskontext zu erstellen.

IBindCtx* CreateBindContext(CFileException* pError);

Parameter

pError
Ein Zeiger auf eine Datei exception. Im Falle eines Fehlers wird sie auf die Ursache festgelegt.

Rückgabewert

Ein Zeiger auf den Bindungskontext IBindCtx , der bei erfolgreicher Bindung gebunden werden soll; andernfalls NULL. Wenn die Instanz mit einer IBindHost Schnittstelle geöffnet wurde, wird der Bindungskontext aus der IBindHost. Wenn keine IBindHost Schnittstelle vorhanden ist oder die Schnittstelle keinen Bindungskontext zurückgibt, wird ein Bindungskontext erstellt. Eine Beschreibung der IBindHost-Schnittstelle finden Sie im Windows SDK.

Hinweise

Ein Bindungskontext ist ein Objekt, das Informationen zu einem bestimmten Moniker-Bindungsvorgang speichert. Sie können diese Funktion außer Kraft setzen, um einen benutzerdefinierten Bindungskontext bereitzustellen.

CMonikerFile::D etach

Rufen Sie diese Funktion auf, um den Datenstrom zu schließen.

BOOL Detach(CFileException* pError = NULL);

Parameter

pError
Ein Zeiger auf eine Datei exception. Im Falle eines Fehlers wird sie auf die Ursache festgelegt.

Rückgabewert

Ungleich Null, wenn erfolgreich, andernfalls 0 (Null).

CMonikerFile::GetMoniker

Rufen Sie diese Funktion auf, um einen Zeiger auf den aktuellen Moniker abzurufen.

IMoniker* GetMoniker() const;

Rückgabewert

Ein Zeiger auf die aktuelle Moniker-Schnittstelle ( IMoniker).

Hinweise

Da CMonikerFile es sich nicht um eine Schnittstelle handelt, erhöht der zurückgegebene Zeiger nicht die Referenzanzahl (über AddRef), und der Moniker wird freigegeben, wenn das CMonikerFile Objekt freigegeben wird. Wenn Sie den Moniker halten oder ihn selbst freigeben möchten, müssen AddRef Sie es.

CMonikerFile::Open

Rufen Sie diese Memberfunktion auf, um ein Datei- oder Moniker-Objekt zu öffnen.

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

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

Parameter

lpszURL
Eine URL oder ein Dateiname der datei, die geöffnet werden soll.

pError
Ein Zeiger auf eine Datei exception. Im Falle eines Fehlers wird sie auf die Ursache festgelegt.

pMoniker
Ein Zeiger auf die moniker-Schnittstelle IMoniker , die zum Abrufen eines Datenstroms verwendet werden soll.

Rückgabewert

Ungleich Null, wenn erfolgreich, andernfalls 0 (Null).

Hinweise

Der lpszURL-Parameter kann auf einem Macintosh nicht verwendet werden. Nur die pMoniker-Form Open kann auf einem Macintosh verwendet werden.

Sie können eine URL oder einen Dateinamen für den lpszURL-Parameter verwenden. Zum Beispiel:

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

- oder -

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

Siehe auch

COleStreamFile-Klasse
Hierarchiediagramm
CAsyncMonikerFile-Klasse