Punti di ingresso delle funzioni DLL esportate
Per le funzioni esportate di una DLL, usare la macro AFX_MANAGE_STATE per mantenere lo stato globale appropriato quando si passa dal modulo DLL alla DLL dell'applicazione chiamante.
Una volta chiamata, questa macro imposta pModuleState, un puntatore a una struttura AFX_MODULE_STATE contenente i dati globali del modulo, come lo stato effettivo del modulo per il resto dell'ambito contenitore della funzione. All'uscita dall'ambito contenente la macro, viene automaticamente ripristinato lo stato effettivo precedente del modulo.
Questo passaggio viene ottenuto creando un'istanza di una AFX_MODULE_STATE classe nello stack. Nel relativo costruttore, questa classe ottiene un puntatore allo stato del modulo corrente e lo archivia in una variabile membro, quindi imposta pModuleState come nuovo stato del modulo effettivo. Nel relativo distruttore, questa classe ripristina il puntatore archiviato nella variabile membro come lo stato del modulo effettivo.
Se si dispone di una funzione esportata, ad esempio una che attiva una finestra di dialogo nella DLL, è necessario aggiungere il seguente codice all'inizio della funzione:
AFX_MANAGE_STATE(AfxGetStaticModuleState())
In questo modo lo stato del modulo corrente viene scambiato con lo stato restituito da AfxGetStaticModuleState fino alla fine dell'ambito corrente.
I problemi con le risorse nelle DLL si verificheranno se non viene utilizzata la macro AFX_MANAGE_STATE. Per impostazione predefinita, MFC utilizza il gestore delle risorse dell'applicazione principale per caricare il modello di risorsa. Questo modello viene effettivamente archiviato nella DLL. La causa radice consiste nel fatto che l'informazione sullo stato del modulo di MFC non è stata scambiata dalla macro AFX_MANAGE_STATE. Il gestore delle risorse viene recuperato dallo stato del modulo di MFC. Non scambiare lo stato del modulo provoca l'utilizzo errato del gestore delle risorse.
AFX_MANAGE_STATE non deve essere necessariamente collocato in ogni funzione nella DLL. Ad esempio, InitInstance può essere chiamato dal codice MFC nell'applicazione senza AFX_MANAGE_STATE perché MFC scambia automaticamente lo stato del modulo prima di InitInstance e quindi lo cambia nuovamente dopo che InitInstance completa la sua esecuzione. Lo stesso vale per tutti i gestori della mappa messaggi. Le DLL MFC regolari hanno effettivamente una routine speciale della finestra master che cambia automaticamente lo stato del modulo prima di instradare qualsiasi messaggio.