Globale functies voor serverregistratie

Opmerking

De ATL (Active Template Library) wordt nog steeds ondersteund. We voegen echter geen functies meer toe of werken de documentatie bij.

Deze functies bieden ondersteuning voor het registreren en ongedaan maken van de registratie van serverobjecten in de objecttoewijzing.

Belangrijk

De functies in de volgende tabel kunnen niet worden gebruikt in toepassingen die worden uitgevoerd in Windows Runtime.

Naam Description
AtlComModuleRegisterServer Deze functie wordt aangeroepen om elk object in de objecttoewijzing te registreren.
AtlComModuleUnregisterServer Deze functie wordt aangeroepen om de registratie van elk object in de objecttoewijzing ongedaan te maken.
AtlComModuleRegisterClassObjects Deze functie wordt aangeroepen om klasseobjecten te registreren.
AtlComModuleRevokeClassObjects Deze functie wordt aangeroepen om klasseobjecten uit een COM-module in te trekken.
AtlComModuleGetClassObject Deze functie wordt aangeroepen om het klasseobject op te halen.

Requirements

Header: atlbase.h

AtlComModuleRegisterServer

Deze functie wordt aangeroepen om elk object in de objecttoewijzing te registreren.

ATLINLINE ATLAPI AtlComModuleRegisterServer(
    _ATL_COM_MODULE* pComModule,
    BOOL bRegTypeLib,
    const CLSID* pCLSID);

Parameterwaarden

pComModule
Aanwijzer naar de COM-module.

bRegTypeLib
WAAR als de typebibliotheek moet worden geregistreerd.

pCLSID
Verwijst naar de CLSID van het object dat moet worden geregistreerd. Als NULL, worden alle objecten in de objecttoewijzing geregistreerd.

Retourwaarde

Retourneert S_OK bij succes of een fout HRESULT bij fout.

Opmerkingen

AtlComModuleRegisterServer begeleidt de automatisch gegenereerde ATL-objecttoewijzing en registreert elk object op de kaart. Als pCLSID niet NULL is, wordt alleen het object waarnaar wordt verwezen door pCLSID geregistreerd; anders worden alle objecten geregistreerd.

Deze functie wordt aangeroepen door CAtlComModule::RegisterServer.

AtlComModuleUnregisterServer

Deze functie wordt aangeroepen om de registratie van elk object in de objecttoewijzing ongedaan te maken.

ATLINLINE ATLAPI AtlComModuleUnregisterServer(
    _ATL_COM_MODULE* pComModule,
    BOOL bUnRegTypeLib,
    const CLSID* pCLSID);

Parameterwaarden

pComModule
Aanwijzer naar de COM-module.

bUnRegTypeLib
WAAR als de typebibliotheek moet worden geregistreerd.

pCLSID
Verwijst naar de CLSID van het object om de registratie ongedaan te maken. Als alle objecten in de objecttoewijzing null zijn, wordt de registratie ongedaan.

Retourwaarde

Retourneert S_OK bij succes of een fout HRESULT bij fout.

Opmerkingen

AtlComModuleUnregisterServer door de ATL-objecttoewijzing te lopen en de registratie van elk object op de kaart ongedaan te maken. Als pCLSID niet NULL is, wordt alleen het object waarnaar wordt verwezen door pCLSID niet geregistreerd; anders worden alle objecten niet geregistreerd.

Deze functie wordt aangeroepen door CAtlComModule::UnregisterServer.

AtlComModuleRegisterClassObjects

Deze functie wordt aangeroepen om klasseobjecten te registreren.

ATLINLINE ATLAPI AtlComModuleRegisterClassObjects(
    _ATL_COM_MODULE* pComModule,
    DWORD dwClsContext,
    DWORD dwFlags);

Parameterwaarden

pComModule
Aanwijzer naar de COM-module.

dwClsContext
Hiermee geeft u de context op waarin het klasseobject moet worden uitgevoerd. Mogelijke waarden zijn CLSCTX_INPROC_SERVER, CLSCTX_INPROC_HANDLER of CLSCTX_LOCAL_SERVER. Zie CLSCTX voor meer informatie.

dwFlags
Bepaalt de verbindingstypen voor het klasseobject. Mogelijke waarden zijn REGCLS_SINGLEUSE, REGCLS_MULTIPLEUSE of REGCLS_MULTI_SEPARATE. Zie REGCLS voor meer informatie.

Retourwaarde

Retourneert S_OK bij succes of een fout HRESULT bij fout.

Opmerkingen

Deze helperfunctie wordt gebruikt door CComModule::RegisterClassObjects (verouderd in ATL 7.0) en CAtlExeModuleT::RegisterClassObjects.

AtlComModuleRevokeClassObjects

Deze functie wordt aangeroepen om de klassefactory/factory's uit de tabel Running Object te verwijderen.

ATLINLINE ATLAPI AtlComModuleRevokeClassObjects(_ATL_COM_MODULE* pComModule);

Parameterwaarden

pComModule
Aanwijzer naar de COM-module.

Retourwaarde

Retourneert S_OK bij succes of een fout HRESULT bij fout.

Opmerkingen

Deze helperfunctie wordt gebruikt door CComModule::RevokeClassObjects (verouderd in ATL 7.0) en CAtlExeModuleT::RevokeClassObjects.

AtlComModuleGetClassObject

Deze functie wordt aangeroepen om de klassefactory te retourneren.

ATLINLINE ATLAPI AtlComModuleGetClassObject(
    _ATL_COM_MODULE* pComModule,
    REFCLSID rclsid,
    REFIID riid,
    LPVOID* ppv);

Parameterwaarden

pComModule
Aanwijzer naar de COM-module.

rclsid
De CLSID van het object dat moet worden gemaakt.

riid
De IID van de aangevraagde interface.

Ppv
Een aanwijzer naar de interfacepointer die wordt geïdentificeerd door riid. Als het object deze interface niet ondersteunt, is PPV ingesteld op NULL.

Retourwaarde

Retourneert S_OK bij succes of een fout HRESULT bij fout.

Opmerkingen

Deze helperfunctie wordt gebruikt door CComModule::GetClassObject (verouderd in ATL 7.0) en CAtlDllModuleT::GetClassObject.

Zie ook

Functies

  • Last updated on