AfxWinInit

Articolo
06/10/2015

Questa funzione viene chiamata dalla funzione fornita da MFC di WinMain, come parte dell'inizializzazione di CWinApp di un'applicazione basata su GUI, inizializzare MFC.

BOOL AFXAPI AfxWinInit( 
   HINSTANCE hInstance, 
   HINSTANCE hPrevInstance, 
   LPTSTR lpCmdLine, 
   int nCmdShow  
);

Parametri

hInstance
Gli handle del modulo attualmente in esecuzione.
hPrevInstance
Handle a un'istanza precedente dell'applicazione. Per un'applicazione basata su win32, questo parametro è sempre NULL.
lpCmdLine
Punta a una stringa con terminazione null che specifica la riga di comando per l'applicazione.
nCmdShow
Specifica come finestra principale di un'applicazione GUI sarebbe visualizzata.

Note

Per un'applicazione console, che non utilizza la funzione fornita da MFC di WinMain, è necessario chiamare direttamente AfxWinInit per inizializzare MFC.

Se si chiama AfxWinInit autonomamente, è necessario dichiarare un'istanza di una classe di CWinApp. Per un'applicazione console, è possibile non derivare la classe da CWinApp simile a quello non utilizzare direttamente un'istanza di CWinApp. Questa tecnica è adatta se si decide di mantenere tutta la funzionalità per l'applicazione nell'implementazione di principale.

Nota

Quando si crea un contesto di attivazione per un assembly, MFC utilizza una risorsa di manifesto fornita dal form dell'utente.Il contesto di attivazione viene creato in AfxWinInit.Per ulteriori informazioni, vedere Supporto per contesti di attivazione nello stato del modulo MFC.

Esempio

#include <afx.h>
#include <afxdb.h>

int _tmain(int /*argc*/, TCHAR* /*argv[]*/, TCHAR* /*envp[]*/)
{
   int nRetCode = 0;

   // initialize MFC and print and error on failure 
   if (!AfxWinInit(::GetModuleHandle(NULL), NULL, ::GetCommandLine(), 0))
   {
      // TODO: change error code to suit your needs
      _tprintf(_T("Fatal Error: MFC initialization failed\n"));
      nRetCode = 1;
   }
   else
   {
      // try to connect to an ODBC database that doesn't exist 
      // (this wouldn't work at all without initializing MFC)

      CDatabase db;
      try
      {
         db.Open(_T("This Databsae Doesn't Exist"));

         // we shouldn't realistically get here

         _tprintf_s(_T("Successful!\n")
            _T("Closing ...\n"));
         db.Close();
         _tprintf_s(_T("Closed!"));
      }
      catch (CDBException* pEx)
      {
         // we got an exception! print an error message 
         // (this wouldn't work without initializing MFC)

         TCHAR sz[1024];

         _tprintf_s(_T("Error: "));
         if (pEx->GetErrorMessage(sz, 1024))
            _tprintf_s(sz);
         else
            _tprintf_s(_T("No error message was available"));
         _tprintf_s(_T("\n"));

         pEx->Delete();

         nRetCode = 1;
      }
   }

   return nRetCode;
}