Funzioni globali di registrazione server
Queste funzioni forniscono il supporto per la registrazione e l'annullamento della registrazione di oggetti server nella mappa oggetti.
Importante
Le funzioni elencate nella tabella seguente non possono essere usate nelle applicazioni eseguite in Windows Runtime.
| Nome | Descrizione |
|---|---|
| AtlComModuleRegisterServer | Questa funzione viene chiamata per registrare ogni oggetto nella mappa oggetto. |
| AtlComModuleUnregisterServer | Questa funzione viene chiamata per annullare la registrazione di ogni oggetto nella mappa oggetto. |
| AtlComModuleRegisterClassObjects | Questa funzione viene chiamata per registrare gli oggetti della classe. |
| AtlComModuleRevokeClassObjects | Questa funzione viene chiamata per revocare gli oggetti classe da un modulo COM. |
| AtlComModuleGetClassObject | Questa funzione viene chiamata per ottenere l'oggetto classe . |
Requisiti
Intestazione: atlbase.h
AtlComModuleRegisterServer
Questa funzione viene chiamata per registrare ogni oggetto nella mappa oggetto.
ATLINLINE ATLAPI AtlComModuleRegisterServer(
_ATL_COM_MODULE* pComModule,
BOOL bRegTypeLib,
const CLSID* pCLSID);
Parametri
pComModule
Puntatore al modulo COM.
bRegTypeLib
TRUE se la libreria dei tipi deve essere registrata.
pCLSID
Punta al CLSID dell'oggetto da registrare. Se NULL, tutti gli oggetti nella mappa oggetti verranno registrati.
Valore restituito
Restituisce S_OK in caso di esito positivo o errore HRESULT in caso di errore.
Osservazioni:
AtlComModuleRegisterServer esegue la mappa degli oggetti generata automaticamente da ATL e registra ogni oggetto nella mappa. Se pCLSID non è NULL, viene registrato solo l'oggetto a cui fa riferimento pCLSID ; in caso contrario, tutti gli oggetti vengono registrati.
Questa funzione viene chiamata da CAtlComModule::RegisterServer.
AtlComModuleUnregisterServer
Questa funzione viene chiamata per annullare la registrazione di ogni oggetto nella mappa oggetto.
ATLINLINE ATLAPI AtlComModuleUnregisterServer(
_ATL_COM_MODULE* pComModule,
BOOL bUnRegTypeLib,
const CLSID* pCLSID);
Parametri
pComModule
Puntatore al modulo COM.
bUnRegTypeLib
TRUE se la libreria dei tipi deve essere registrata.
pCLSID
Punta al CLSID dell'oggetto da annullare. Se null tutti gli oggetti nella mappa oggetti verranno annullati la registrazione.
Valore restituito
Restituisce S_OK in caso di esito positivo o errore HRESULT in caso di errore.
Osservazioni:
AtlComModuleUnregisterServer esegue la mappa degli oggetti ATL e annulla la registrazione di ogni oggetto nella mappa. Se pCLSID non è NULL, solo l'oggetto a cui fa riferimento pCLSID viene annullata la registrazione. In caso contrario, tutti gli oggetti non vengono registrati.
Questa funzione viene chiamata da CAtlComModule::UnregisterServer.
AtlComModuleRegisterClassObjects
Questa funzione viene chiamata per registrare gli oggetti della classe.
ATLINLINE ATLAPI AtlComModuleRegisterClassObjects(
_ATL_COM_MODULE* pComModule,
DWORD dwClsContext,
DWORD dwFlags);
Parametri
pComModule
Puntatore al modulo COM.
dwClsContext
Specifica il contesto in cui deve essere eseguito l'oggetto classe. I valori possibili sono CLSCTX_INPROC_SERVER, CLSCTX_INPROC_HANDLER o CLSCTX_LOCAL_SERVER. Per altri dettagli, vedere CLSCTX .
dwFlags
Determina i tipi di connessione all'oggetto classe. I valori possibili sono REGCLS_SINGLEUSE, REGCLS_MULTIPLEUSE o REGCLS_MULTI_SEPARATE. Per altri dettagli, vedere REGCLS .
Valore restituito
Restituisce S_OK in caso di esito positivo o errore HRESULT in caso di errore.
Osservazioni:
Questa funzione helper viene utilizzata da CComModule::RegisterClassObjects (obsoleto in ATL 7.0) e CAtlExeModuleT::RegisterClassObjects.
AtlComModuleRevokeClassObjects
Questa funzione viene chiamata per rimuovere le class factory dalla tabella degli oggetti in esecuzione.
ATLINLINE ATLAPI AtlComModuleRevokeClassObjects(_ATL_COM_MODULE* pComModule);
Parametri
pComModule
Puntatore al modulo COM.
Valore restituito
Restituisce S_OK in caso di esito positivo o errore HRESULT in caso di errore.
Osservazioni:
Questa funzione helper viene usata da CComModule::RevokeClassObjects (obsoleto in ATL 7.0) e CAtlExeModuleT::RevokeClassObjects.
AtlComModuleGetClassObject
Questa funzione viene chiamata per restituire la class factory.
ATLINLINE ATLAPI AtlComModuleGetClassObject(
_ATL_COM_MODULE* pComModule,
REFCLSID rclsid,
REFIID riid,
LPVOID* ppv);
Parametri
pComModule
Puntatore al modulo COM.
rclsid
CLSID dell'oggetto da creare.
riid
IID dell'interfaccia richiesta.
ppv
Puntatore al puntatore all'interfaccia identificato da riid. Se l'oggetto non supporta questa interfaccia, ppv è impostato su NULL.
Valore restituito
Restituisce S_OK in caso di esito positivo o errore HRESULT in caso di errore.
Osservazioni:
Questa funzione helper viene usata da CComModule::GetClassObject (obsoleto in ATL 7.0) e CAtlDllModuleT::GetClassObject.