CMonikerFile-klasse

Opmerking

De Microsoft Foundation Classes-bibliotheek (MFC) wordt nog steeds ondersteund. We voegen echter geen functies meer toe of werken de documentatie bij.

Vertegenwoordigt een gegevensstroom ( IStream) die wordt genoemd door een IMoniker.

Syntaxis

class CMonikerFile : public COleStreamFile

Leden

Openbare constructors

Naam	Description
CMonikerFile::CMonikerFile	Maakt een CMonikerFile object.

Openbare methoden

Naam	Description
CMonikerFile::Close	Loskoppelt en publiceert de stream en brengt de moniker uit.
CMonikerFile::D etach	Loskoppelt het IMoniker van dit CMonikerFile object.
CMonikerFile::GetMoniker	Retourneert de huidige moniker.
CMonikerFile::Open	Hiermee opent u het opgegeven bestand om een stream te verkrijgen.

Beveiligde methoden

Naam	Description
CMonikerFile::CreateBindContext	Hiermee haalt u de bindingscontext op of maakt u een standaard geïnitialiseerde bindingscontext.

Opmerkingen

Een moniker bevat informatie zoals een padnaam naar een bestand. Als u een aanwijzer hebt naar de interface van IMoniker een monikerobject, kunt u toegang krijgen tot het geïdentificeerde bestand zonder dat u andere specifieke informatie hebt over de locatie van het bestand.

Afgeleid van COleStreamFile, CMonikerFile neemt een moniker of een tekenreeksweergave die het kan maken in een moniker en bindt deze aan de stroom waarvoor de moniker een naam is. Vervolgens kunt u lezen en schrijven naar die stream. Het echte doel is CMonikerFile om eenvoudige toegang te bieden tot IStreams benoemde IMonikers, zodat u zich niet hoeft te binden aan een stream, maar toch functionaliteit voor de stream hebt CFile .

CMonikerFile kan niet worden gebruikt om verbinding te maken met iets anders dan een stream. Als u verbinding wilt maken met opslag of een object, moet u de IMoniker interface rechtstreeks gebruiken.

Zie COleStreamFile in de MFC Reference and IStream en IMoniker in de Windows SDK voor meer informatie over streams en monikers.

Overnamehiërarchie

CObject

CFile-

COleStreamFile

CMonikerFile

Requirements

Koptekst: afxole.h

CMonikerFile::Close

Roep deze functie aan om de stream los te koppelen en vrij te geven en de moniker vrij te geven.

virtual void Close();

Opmerkingen

Kan worden aangeroepen op niet-geopende of al gesloten streams.

CMonikerFile::CMonikerFile

Maakt een CMonikerFile object.

CMonikerFile();

CMonikerFile::CreateBindContext

Roep deze functie aan om een standaardcontext voor geïnitialiseerde binding te maken.

IBindCtx* CreateBindContext(CFileException* pError);

Parameterwaarden

pError
Een aanwijzer naar een bestandsonderzondering. In het geval van een fout wordt deze ingesteld op de oorzaak.

Retourwaarde

Een aanwijzer naar de bindingscontext-IBindCtx waarmee verbinding kan worden gemaakt indien geslaagd; anders NULL. Als het exemplaar is geopend met een IBindHost interface, wordt de bindingscontext opgehaald uit de IBindHost. Als er geen IBindHost interface is of als de interface geen bindingscontext retourneert, wordt er een bindingscontext gemaakt. Zie de Windows SDK voor een beschrijving van de IBindHost-interface .

Opmerkingen

Een bindingscontext is een object waarin informatie over een bepaalde monikerbindingsbewerking wordt opgeslagen. U kunt deze functie overschrijven om een aangepaste bindingscontext te bieden.

CMonikerFile::D etach

Roep deze functie aan om de stream te sluiten.

BOOL Detach(CFileException* pError = NULL);

Parameterwaarden

pError
Een aanwijzer naar een bestandsonderzondering. In het geval van een fout wordt deze ingesteld op de oorzaak.

Retourwaarde

Niet-nul indien geslaagd; anders 0.

CMonikerFile::GetMoniker

Roep deze functie aan om een aanwijzer op te halen naar de huidige moniker.

IMoniker* GetMoniker() const;

Retourwaarde

Een aanwijzer naar de huidige monikerinterface ( IMoniker).

Opmerkingen

Omdat CMonikerFile dit geen interface is, wordt met de geretourneerde aanwijzer het aantal verwijzingen (via AddRef) niet verhoogd en wordt de moniker vrijgegeven wanneer het CMonikerFile object wordt vrijgegeven. Als u de moniker wilt vasthouden of het zelf wilt vrijgeven, moet u het doen AddRef .

CMonikerFile::Open

Roep deze lidfunctie aan om een bestand of monikerobject te openen.

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

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

Parameterwaarden

lpszURL
Een URL of bestandsnaam van het bestand dat moet worden geopend.

pError
Een aanwijzer naar een bestandsonderzondering. In het geval van een fout wordt deze ingesteld op de oorzaak.

pMoniker
Een aanwijzer naar de moniker-interface IMoniker die moet worden gebruikt om een stream te verkrijgen.

Retourwaarde

Niet-nul indien geslaagd; anders 0.

Opmerkingen

De parameter lpszURL kan niet worden gebruikt voor een Macintosh. Alleen de pMoniker-vormOpen kan op een Macintosh worden gebruikt.

U kunt een URL of een bestandsnaam gebruiken voor de parameter lpszURL . Voorbeeld:

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

- of -

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

Zie ook

COleStreamFile-klasse
Hiërarchiegrafiek
Klasse CAsyncMonikerFile