Condividi tramite


DLL regolari collegate a MFC in modo dinamico

Aggiornamento: novembre 2007

Una DLL regolare collegata a MFC in modo dinamico utilizza MFC internamente e le funzioni esportate da essa possono essere chiamate da file eseguibili MFC o non MFC. Questo tipo di DLL viene generato mediante la versione di libreria a collegamento dinamico di MFC, anche detta versione condivisa di MFC. Le funzioni sono generalmente esportate da una DLL regolare mediante l'interfaccia C standard.

È necessario aggiungere la macro AFX_MANAGE_STATE all'inizio di tutte le funzioni esportate dalle DLL regolari collegate a MFC in modo dinamico per impostare lo stato del modulo corrente su quello della DLL. A questo scopo, è possibile aggiungere la seguente riga di codice all'inizio delle funzioni esportate dalla DLL:

AFX_MANAGE_STATE(AfxGetStaticModuleState( ))

Una DLL regolare collegata a MFC in modo dinamico ha le caratteristiche descritte di seguito.

  • Si tratta di un nuovo tipo di DLL introdotto da Visual C++ 4.0.

  • L'eseguibile client può essere compilato in uno qualsiasi dei linguaggi che supportano l'utilizzo delle DLL: C, C++, Pascal, Visual Basic e così via. Non occorre pertanto che sia un'applicazione MFC.

  • A differenza della DLL regolare collegata in modo statico, questo tipo di DLL è collegato in modo dinamico alla DLL MFC, anche detta DLL MFC condivisa.

  • La libreria di importazione MFC collegata a questo tipo di DLL è la stessa utilizzata per le DLL di estensione o per le applicazioni che utilizzano la DLL MFC, ovvero MFCxx(D).lib.

Di seguito sono riportati i requisiti delle DLL regolari collegate in modo dinamico a MFC:

  • Queste DLL devono essere compilate con il simbolo _AFXDLL definito, proprio come un eseguibile collegato alla DLL MFC in modo dinamico, e anche con il simbolo _USRDLL, proprio come una DLL regolare collegata a MFC in modo statico.

  • Questo tipo di DLL deve creare un'istanza di una classe derivata da CWinApp.

  • Questo tipo di DLL utilizza DllMain fornita da MFC. Inserire tutto il codice di inizializzazione specifico della DLL nella funzione membro InitInstance e il codice di terminazione in ExitInstance come in una normale applicazione MFC.

Poiché questo tipo di DLL utilizza la versione della libreria a collegamento dinamico di MFC, è necessario impostare esplicitamente lo stato del modulo corrente su quello della DLL. A tal fine, utilizzare la macro AFX_MANAGE_STATE all'inizio di ogni funzione esportata dalla DLL.

Le DLL regolari devono avere una classe derivata da CwinApp e un singolo oggetto di tale classe applicazione, come le applicazioni MFC. Tuttavia, l'oggetto CWinApp della DLL non dispone di un message pump principale, a differenza dell'oggetto CWinApp di un'applicazione.

Tenere presente che il meccanismo CWinApp::Run non è applicabile a una DLL, poiché l'applicazione possiede il message pump principale. Se la DLL visualizza finestre di dialogo non modali o contiene una propria finestra cornice principale, il message pump principale dell'applicazione deve chiamare una routine esportata da DLL che chiama CWinApp::PreTranslateMessage.

Inserire tutto il codice di inizializzazione specifico della DLL nella funzione membro CWinApp::InitInstance come in una normale applicazione MFC. La funzione membro CWinApp::ExitInstance della classe derivata da CWinApp verrà chiamata dalla funzione DllMain fornita da MFC prima che la DLL venga scaricata.

È necessario distribuire le DLL condivise MFCx0.dll e Msvcr*0.dll (o file simili) con l'applicazione.

Una DLL collegata a MFC in modo dinamico non può essere anche collegata a MFC in modo statico. Le applicazioni si collegano alle DLL regolari collegate a MFC in modo dinamico come qualsiasi altra DLL.

I simboli sono generalmente esportati da una DLL regolare mediante l'interfaccia C standard. La dichiarazione di una funzione esportata da una DLL regolare è simile alla seguente:

extern "C" __declspec(dllexport) MyExportedFunction( );

Tutte le assegnazioni di memoria in una DLL regolare devono rimanere nella DLL, la quale non deve passare o ricevere uno dei seguenti elementi dall'eseguibile chiamante:

  • puntatori agli oggetti MFC;

  • puntatori alla memoria assegnata da MFC.

Se è necessario effettuare una di queste operazioni o passare gli oggetti derivati da MFC tra l'eseguibile chiamante e la DLL, occorre generare una DLL di estensione.

I puntatori alla memoria assegnata dalle librerie di runtime C possono essere passati in modo sicuro tra un'applicazione e una DLL solo se si effettua una copia dei dati. Non eliminare, ridimensionare o utilizzare questi puntatori senza creare una copia della memoria.

Quando si genera una DLL regolare collegata a MFC in modo dinamico, è necessario utilizzare la macro AFX_MANAGE_STATE per impostare correttamente lo stato del modulo MFC aggiungendo la seguente riga di codice all'inizio delle funzioni esportate dalla DLL:

AFX_MANAGE_STATE(AfxGetStaticModuleState( ))

La macro AFX_MANAGE_STATE non deve essere utilizzata nelle DLL regolari collegate a MFC in modo statico o nelle DLL di estensione. Per ulteriori informazioni, vedere Gestione dei dati dello stato dei moduli MFC.

Per un esempio sulla creazione, sulla generazione e sull'utilizzo di una DLL regolare, vedere DLLScreenCap. Per ulteriori informazioni sulle DLL regolari collegate in modo dinamico a MFC, vedere la sezione relativa alla conversione di DLLScreenCap per il collegamento dinamico alla DLL MFC nell'esempio.

Scegliere l'argomento con cui si desidera procedere

Scegliere l'argomento su cui visualizzare maggiori informazioni

Vedere anche

Concetti

Tipi di DLL