Freigeben über


CWinApp::InitInstance

Windows ermöglicht mehreren Kopien desselben Programms, um gleichzeitig ausführen.

virtual BOOL InitInstance( );

Rückgabewert

Ungleich 0 (null), wenn die Initialisierung erfolgreich ist; 0 andernfalls.

Hinweise

Anwendungsinitialisierung Prinzip ist in zwei Abschnitte unterteilt: einmalige Anwendungsinitialisierung, der das erste Mal das Programm ausgeführt wird, wird Instanzinitialisierung und wird jedes Mal eine Kopie der Programmausführungen ausgeführt und das erste Mal enthält. Die Implementierung des Frameworks von WinMain ruft diese Funktion auf.

Überschreiben Sie InitInstance, um jede neue Instanz des laufenden Anwendung unter Windows zu initialisieren. In der Regel überschreiben Sie InitInstance, um das Hauptfensterobjekt zu erstellen und den CWinThread::m_pMainWnd Datenmember festzulegen, um sich zu diesem Fenster angezeigt werden. Weitere Informationen zum Überschreiben dieser Memberfunktion, finden Sie unter CWinApp: Die Application-Klasse.

Hinweis

MFC-Anwendungen müssen als Singlethreadapartment (STA) initialisiert werden.Wenn Sie CoInitializeEx in der InitInstance Überschreibung aufrufen, geben Sie COINIT_APARTMENTTHREADED an (statt COINIT_MULTITHREADED).Weitere Informationen finden Sie unter PRB: MFC-Anwendung zu reagieren, wird beendet, wenn Sie die Anwendung als Multithread-Apartment (828643) mit https://support.microsoft.com/default.aspx?scid=kb;en-us;828643 initialisieren.

Beispiel

// AppWizard implements the InitInstance overridable function  
// according to options you select.  For example, the multiple document 
// interface (MDI) option was chosen for the AppWizard code created 
// below. You can add other per-instance initializations to the code 
// created by AppWizard.

BOOL CMFCListViewApp::InitInstance()
{
   AfxSetAmbientActCtx(FALSE);
   // Remainder of function definition omitted.

   CWinApp::InitInstance();

   // Initialize OLE libraries 
   if (!AfxOleInit())
   {
      AfxMessageBox(_T("OleInit failed."));
      return FALSE;
   }

   // Standard initialization 
   // If you are not using these features and wish to reduce the size 
   // of your final executable, you should remove from the following 
   // the specific initialization routines you do not need 
   // Change the registry key under which our settings are stored 
   // TODO: You should modify this string to be something appropriate 
   // such as the name of your company or organization
   SetRegistryKey(_T("Local AppWizard-Generated Applications"));
   LoadStdProfileSettings(4);  // Load standard INI file options (including MRU) 
   // Register the application's document templates.  Document templates 
   //  serve as the connection between documents, frame windows and views
   CMultiDocTemplate* pDocTemplate;
   pDocTemplate = new CMultiDocTemplate(IDR_MFCListViewTYPE,
      RUNTIME_CLASS(CMFCListViewDoc),
      RUNTIME_CLASS(CChildFrame), // custom MDI child frame
      RUNTIME_CLASS(CMyListView));
   if (!pDocTemplate)
      return FALSE;
   AddDocTemplate(pDocTemplate);

   // create main MDI Frame window
   CMainFrame* pMainFrame = new CMainFrame;
   if (!pMainFrame || !pMainFrame->LoadFrame(IDR_MAINFRAME))
   {
      delete pMainFrame;
      return FALSE;
   }
   m_pMainWnd = pMainFrame;
   // call DragAcceptFiles only if there's a suffix 
   //  In an MDI app, this should occur immediately after setting m_pMainWnd 


   // Parse command line for standard shell commands, DDE, file open
   CCommandLineInfo cmdInfo;
   ParseCommandLine(cmdInfo);


   // Dispatch commands specified on the command line.  Will return FALSE if 
   // app was launched with /RegServer, /Register, /Unregserver or /Unregister. 
   if (!ProcessShellCommand(cmdInfo))
      return FALSE;
   // The main window has been initialized, so show and update it
   pMainFrame->ShowWindow(m_nCmdShow);
   pMainFrame->UpdateWindow();

   return TRUE;
}

Anforderungen

Header: afxwin.h

Siehe auch

Referenz

CWinApp-Klasse

Hierarchiediagramm