애플리케이션 정보 및 관리

애플리케이션을 작성할 때 단일 CWinApp파생 개체를 만듭니다. 때때로 파생 개체 외부에서 이 개체에 CWinApp대한 정보를 가져올 수 있습니다. 또는 다른 전역 "관리자" 개체에 액세스해야 할 수도 있습니다.

Microsoft Foundation 클래스 라이브러리는 이러한 작업을 수행하는 데 도움이 되는 다음과 같은 전역 함수를 제공합니다.

애플리케이션 정보 및 관리 함수

속성	설명
AfxBeginThread	새 스레드를 만듭니다.
AfxContextMenuManager	전역 상황에 맞는 메뉴 관리자에 대한 포인터입니다.
AfxEndThread	현재 스레드를 종료합니다.
AfxFindResourceHandle	리소스 체인을 안내하고 리소스 ID 및 리소스 종류별로 특정 리소스를 찾습니다.
AfxFreeLibrary	로드된 DLL(동적 연결 라이브러리) 모듈의 참조 수를 줄입니다. 참조 수가 0에 도달하면 모듈의 매핑이 해제됩니다.
AfxGetApp	애플리케이션의 단일 CWinApp 개체에 대한 포인터를 반환합니다.
AfxGetAppName	애플리케이션의 이름을 포함하는 문자열을 반환합니다.
AfxGetInstanceHandle	애플리케이션의 HINSTANCE 이 인스턴스를 나타내는 값을 반환합니다.
AfxGetMainWnd	OLE가 아닌 애플리케이션의 현재 "main" 창 또는 서버 애플리케이션의 현재 위치 프레임 창에 대한 포인터를 반환합니다.
AfxGetPerUserRegistration	이 함수를 사용하여 애플리케이션이 (HKCU) 노드에 대한 레지스트리 액세스를 HKEY_CURRENT_USER 리디렉션하는지 여부를 확인합니다.
AfxGetResourceHandle	HINSTANCE 애플리케이션의 기본 리소스 원본을 반환합니다. 애플리케이션의 리소스에 직접 액세스하는 데 사용합니다.
AfxGetThread	현재 CWinThread 개체에 대한 포인터를 검색합니다.
AfxInitRichEdit	애플리케이션에 대한 버전 1.0 리치 편집 컨트롤을 초기화합니다.
AfxInitRichEdit2	애플리케이션에 대한 버전 2.0 이상 서식 있는 편집 컨트롤을 초기화합니다.
AfxIsExtendedFrameClass	지정된 창이 확장된 프레임 개체인지 여부를 확인합니다.
AfxIsMFCToolBar	지정된 창이 도구 모음 개체인지 여부를 확인합니다.
AfxKeyboardManager	전역 키보드 관리자에 대한 포인터입니다.
AfxLoadLibrary	DLL 모듈을 매핑하고 DLL 함수의 주소를 가져오는 데 사용할 수 있는 핸들을 반환합니다.
AfxLoadLibraryEx	지정된 옵션을 사용하여 DLL 모듈을 매핑하고 DLL 함수의 주소를 가져오는 데 사용할 수 있는 핸들을 반환합니다.
AfxMenuTearOffManager	전역 분리 메뉴 관리자에 대한 포인터입니다.
AfxMouseManager	전역 마우스 관리자에 대한 포인터입니다.
AfxRegisterClass	MFC를 사용하는 DLL에 창 클래스를 등록합니다.
AfxRegisterWndClass	Windows 창 클래스를 등록하여 MFC에 의해 자동으로 등록된 클래스를 보완합니다.
AfxSetPerUserRegistration	애플리케이션이 (HKCU) 노드에 대한 레지스트리 액세스를 HKEY_CURRENT_USER 리디렉션하는지 여부를 설정합니다.
AfxSetResourceHandle	애플리케이션의 기본 리소스가 로드되는 HINSTANCE 핸들을 설정합니다.
AfxShellManager	전역 셸 관리자에 대한 포인터입니다.
AfxSocketInit	Windows 소켓을 CWinApp::InitInstance 초기화하기 위해 재정의에서 호출됩니다.
AfxUserToolsManager	전역 사용자 도구 관리자에 대한 포인터입니다.
AfxWinInit	MFC를 초기화하기 위해 GUI 기반 애플리케이션 초기화의 CWinApp 일부로 MFC 제공 WinMain 함수에 의해 호출됩니다. MFC를 사용하는 콘솔 애플리케이션에 대해 직접 호출해야 합니다.

AfxBeginThread

이 함수를 호출하여 새 스레드를 만듭니다.

CWinThread* AfxBeginThread(
    AFX_THREADPROC pfnThreadProc,
    LPVOID pParam,
    int nPriority = THREAD_PRIORITY_NORMAL,
    UINT nStackSize = 0,
    DWORD dwCreateFlags = 0,
    LPSECURITY_ATTRIBUTES lpSecurityAttrs = NULL);

CWinThread* AfxBeginThread(
    CRuntimeClass* pThreadClass,
    int nPriority = THREAD_PRIORITY_NORMAL,
    UINT nStackSize = 0,
    DWORD dwCreateFlags = 0,
    LPSECURITY_ATTRIBUTES lpSecurityAttrs = NULL);

매개 변수

pfnThreadProc
작업자 스레드에 대한 제어 함수를 가리킵니다. 포인터가 될 NULL수 없습니다. 이 함수는 다음과 같이 선언해야 합니다.

UINT __cdecl MyControllingFunction( LPVOID pParam );

pThreadClass
RUNTIME_CLASS 에서 파생된 개체의 형식입니다CWinThread.

pParam
제어 함수에 전달할 매개 변수입니다.

nPriority
스레드에 대해 설정할 우선 순위입니다. 사용 가능한 우선 순위에 대한 전체 목록 및 설명은 Windows SDK를 참조 SetThreadPriority 하세요.

nStackSize
새 스레드에 대한 스택의 크기(바이트)를 지정합니다. 0이면 스택 크기는 기본적으로 만드는 스레드와 동일한 크기 스택으로 설정됩니다.

dwCreateFlags
스레드 생성을 제어하는 추가 플래그를 지정합니다. 이 플래그는 다음 두 값 중 하나를 포함할 수 있습니다.

• CREATE_SUSPENDED 일시 중단 횟수 1로 스레드를 시작합니다. 스레드가 실행되기 전에 개체의 CWinThread 멤버 데이터(예: m_bAutoDelete 파생 클래스의 멤버)를 초기화하려는 경우에 사용합니다CREATE_SUSPENDED. 초기화가 완료되면 스레드 실행을 시작하는 데 사용합니다 CWinThread::ResumeThread . 스레드는 호출될 때까지 CWinThread::ResumeThread 실행되지 않습니다.

• 0 만든 직후 스레드를 시작합니다.

lpSecurityAttrs
스레드의 SECURITY_ATTRIBUTES 보안 특성을 지정하는 구조를 가리킵니다. 이 경우 NULL만드는 스레드와 동일한 보안 특성이 사용됩니다. 이 구조에 대한 자세한 내용은 Windows SDK를 참조하세요.

Return Value

새로 만든 스레드 개체에 대한 포인터이거나 NULL 오류가 발생하는 경우

설명

첫 번째 형식은 AfxBeginThread 작업자 스레드를 만듭니다. 두 번째 양식은 사용자 인터페이스 스레드 또는 작업자 스레드로 사용할 수 있는 스레드를 만듭니다.

AfxBeginThread 는 새 CWinThread 개체를 만들고, 해당 CreateThread 함수를 호출하여 스레드 실행을 시작하고, 스레드에 대한 포인터를 반환합니다. 생성의 일부가 실패할 경우 모든 개체의 할당이 제대로 취소되었는지 확인하기 위해 프로시저 전체에서 검사가 수행됩니다. 스레드를 종료하려면 스레드 내에서 호출 AfxEndThread 하거나 작업자 스레드의 제어 함수에서 반환합니다.

애플리케이션에서 다중 스레딩을 사용하도록 설정해야 합니다. 그렇지 않으면 이 함수가 실패합니다. 다중 스레딩/MD을 사용하도록 설정하는 방법에 대한 자세한 내용은 , /MT/LD (런타임 라이브러리 사용)을 참조하세요.

자세한 AfxBeginThread내용은 다중 스레딩: 작업자 스레드 만들기 및 다중 스레딩: 사용자 인터페이스 스레드 만들기 문서를 참조하세요.

예시

CSocket::Attach에 대한 예를 참조하세요.

요구 사항

머리글 afxwin.h

AfxContextMenuManager

전역 상황에 맞는 메뉴 관리자에 대한 포인터입니다.

구문

CContextMenuManager* afxContextMenuManager;

요구 사항

머리글: afxcontextmenumanager.h

AfxEndThread

이 함수를 호출하여 현재 실행 중인 스레드를 종료합니다.

void AFXAPI AfxEndThread(
    UINT nExitCode,
    BOOL bDelete  = TRUE);

매개 변수

nExitCode
스레드의 종료 코드를 지정합니다.

bDelete
메모리에서 스레드 개체를 삭제합니다.

설명

종료하려면 스레드 내에서 호출해야 합니다.

자세한 AfxEndThread내용은 다중 스레딩: 스레드 종료 문서를 참조하세요.

요구 사항

머리글 afxwin.h

AfxFindResourceHandle

리소스 체인을 안내하고 리소스 ID 및 리소스 종류별로 특정 리소스를 찾는 데 사용합니다 AfxFindResourceHandle .

구문

HINSTANCE AFXAPI AfxFindResourceHandle( LPCTSTR lpszName,  LPCTSTR lpszType );

매개 변수

lpszName
리소스 ID를 포함하는 문자열에 대한 포인터입니다. lpszType
리소스 유형에 대한 포인터입니다. 리소스 종류 목록은 Windows SDK를 참조 FindResource 하세요.

Return Value

리소스를 포함하는 모듈에 대한 핸들입니다.

설명

AfxFindResourceHandle 는 특정 리소스를 찾고 리소스가 포함된 모듈에 대한 핸들을 반환합니다. 리소스가 로드된 모든 MFC 확장 DLL에 있을 수 있습니다. AfxFindResourceHandle 는 리소스가 있는 항목을 알려줍니다.

모듈은 다음 순서로 검색됩니다.

1. MFC 확장 DLL인 경우 주 모듈입니다.

2. 비 시스템 모듈.

3. 언어별 모듈.

4. 기본 모듈(시스템 DLL인 경우)입니다.

5. 시스템 모듈.

요구 사항

머리글: afxwin.h

AfxFreeLibrary

AfxFreeLibrary 및 AfxLoadLibrary는 각 코딩된 라이브러리 모듈에 대한 참조 횟수를 유지 관리합니다.

BOOL AFXAPI AfxFreeLibrary(HINSTANCE hInstLib);

매개 변수

hInstLib
로드된 라이브러리 모듈의 핸들입니다. AfxLoadLibrary 는 이 핸들을 반환합니다.

Return Value

TRUE함수가 성공하면 FALSE

설명

AfxFreeLibrary는 로드된 DLL(동적 연결 라이브러리) 모듈의 참조 횟수를 감소시킵니다. 참조 횟수가 0에 도달하면, 호출 프로세스의 주소 공간에서 모듈이 매핑 해제되고 핸들이 더 이상 유효하지 않습니다. 이 참조 카운트는 AfxLoadLibrary가 호출될 때마다 매번 증가합니다.

라이브러리 모듈을 매핑 해제하기 전에 시스템은 DLL이 이를 사용하는 프로세스에서 분리할 수 있게 해줍니다. 이렇게 하면 DLL이 현재 프로세스에 할당된 리소스를 정리할 수 있습니다. 진입점 함수가 반환된 다음 라이브러리 모듈은 현재 프로세스의 주소 공간에서 제거됩니다.

AfxLoadLibrary를 사용해서 DLL 모듈을 매핑합니다.

애플리케이션에서 여러 스레드를 사용하는 AfxFreeLibrary AfxLoadLibrary 경우 Win32 함수 FreeLibrary LoadLibrary대신 사용해야 합니다. MFC 확장 DLL이 로드되고 AfxFreeLibrary 언로드될 때 실행되는 시작 및 종료 코드가 전역 MFC 상태를 손상시키지 않도록 합니다AfxLoadLibrary.

예시

AfxLoadLibrary에 대한 예를 참조하세요.

요구 사항

머리글 afxdll_.h

AfxGetApp

이 함수에서 반환된 포인터를 사용하여 기본 메시지 디스패치 코드 또는 맨 위 창과 같은 애플리케이션 정보에 액세스할 수 있습니다.

CWinApp* AFXAPI AfxGetApp();

Return Value

애플리케이션의 단일 CWinApp 개체에 대한 포인터입니다.

설명

이 메서드가 반환 NULL되면 애플리케이션 주 창이 아직 완전히 초기화되지 않았음을 나타낼 수 있습니다. 문제가 있음을 나타낼 수도 있습니다.

예시

// Print the application's executable filename.
TRACE(_T("Executable filename = %s\n"), AfxGetApp()->m_pszExeName);

요구 사항

머리글 afxwin.h

AfxGetAppName

반환된 문자열은 진단 메시지 또는 임시 문자열 이름의 루트로 사용할 수 있습니다.

LPCTSTR AFXAPI AfxGetAppName();

Return Value

애플리케이션의 이름을 포함하는 null로 끝나는 문자열입니다.

예시

// Print the application name to the debugger output window.
TRACE(_T("Application name is %s\n"), AfxGetAppName());

요구 사항

머리글 afxwin.h

AfxGetInstanceHandle

이 함수를 사용하면 현재 애플리케이션의 인스턴스 핸들을 검색할 수 있습니다.

HINSTANCE  AFXAPI AfxGetInstanceHandle();

Return Value

HINSTANCE 애플리케이션의 현재 인스턴스에 대한 것입니다. MFC HINSTANCE 의 USRDLL 버전과 연결된 DLL 내에서 호출되는 경우 DLL에 대한 값이 반환됩니다.

설명

AfxGetInstanceHandle MFC의 USRDLL 버전과 연결된 DLL 내에서 호출되지 않는 한 항상 실행 파일(.EXE)을 반환 HINSTANCE 합니다. 이 경우 DLL에 HINSTANCE 반환됩니다.

예시

// Print the application instance handle to the debugger output window.
TRACE(_T("Application instance handle is 0x%0X\n"), AfxGetInstanceHandle());

요구 사항

머리글 afxwin.h

AfxGetMainWnd

애플리케이션이 OLE 서버인 경우 이 함수를 호출하여 애플리케이션의 활성 주 창에 대한 포인터를 검색합니다. 애플리케이션 개체의 멤버를 직접 참조하는 m_pMainWnd 대신 이 결과를 사용합니다.

CWnd* AFXAPI AfxGetMainWnd();

Return Value

현재 컨테이너 내에서 현재 위치에 활성 상태인 개체가 서버에 있는 경우 현재 위치 활성 문서를 포함하는 프레임 창 개체에 대한 포인터를 반환합니다.

컨테이너 내에서 활성 상태인 개체가 없거나 애플리케이션이 OLE 서버가 아닌 경우 이 함수는 애플리케이션 개체의 반환을 반환 m_pMainWnd 합니다.

애플리케이션의 기본 스레드에서 AfxGetMainWnd가 호출되는 경우 위의 규칙에 따라 애플리케이션의 주 창이 반환됩니다. 함수가 애플리케이션의 보조 스레드에서 호출되면 함수는 호출한 스레드에 연결된 주 창을 반환합니다.

설명

애플리케이션이 OLE 서버가 아닌 경우 이 함수를 호출하는 것은 애플리케이션 개체의 멤버를 직접 참조하는 m_pMainWnd 것과 같습니다.

예시

//The following line send a WM_CLOSE message
//   to the Application's main window. This will cause the
//   Application to exit.
AfxGetMainWnd()->PostMessage(WM_CLOSE, 0, 0);

요구 사항

머리글 afxwin.h

AfxGetPerUserRegistration

이 함수를 사용하여 애플리케이션이 (HKCU) 노드에 대한 레지스트리 액세스를 HKEY_CURRENT_USER 리디렉션하는지 여부를 확인합니다.

BOOL AFXAPI AfxGetPerUserRegistration();

Return Value

TRUE 는 레지스트리 정보가 노드로 전달됨을 HKCU 나타냅니다. FALSE 는 애플리케이션이 기본 노드에 레지스트리 정보를 씁니다. 기본 노드는 (HKCR)입니다 HKEY_CLASSES_ROOT .

설명

레지스트리 리디렉션을 사용하도록 설정하면 프레임워크가 액세스를 .로 HKCR HKEY_CURRENT_USER\Software\Classes리디렉션합니다. MFC 및 ATL 프레임워크만 리디렉션의 영향을 받습니다.

애플리케이션이 레지스트리 액세스를 리디렉션하는지 여부를 변경하려면 .를 사용합니다 AfxSetPerUserRegistration.

요구 사항

머리글 afxstat_.h

AfxGetResourceHandle

이 함수에서 HINSTANCE 반환된 핸들을 사용하여 애플리케이션의 리소스에 직접 액세스합니다(예: Windows 함수 FindResource호출).

extern HINSTANCE  AfxGetResourceHandle();

Return Value

HINSTANCE 애플리케이션의 기본 리소스가 로드되는 핸들입니다.

예시

//Load the menu specifying the module handle where resource is to be
//found & resource ID
HMENU hMenu = ::LoadMenu(AfxGetResourceHandle(), MAKEINTRESOURCE(IDR_MAINFRAME));

요구 사항

머리글 afxwin.h

AfxGetThread

이 함수를 호출하여 현재 실행 중인 스레드를 CWinThread 나타내는 개체에 대한 포인터를 가져옵니다.

CWinThread* AfxGetThread();

Return Value

현재 실행 중인 스레드에 대한 포인터입니다. 그렇지 않으면 NULL.

설명

스레드 내에서 호출해야 합니다.

참고 항목

Visual C++ 버전 4.2, 5.0 또는 6.0 AfxGetThread 에서 호출하는 AfxGetThread MFC 프로젝트를 포팅하는 경우 스레드가 없는 경우 호출 AfxGetApp 합니다. 최신 버전의 컴파일러 AfxGetThread 에서 스레드가 없는 경우 반환합니다 NULL . 애플리케이션 스레드를 원하는 경우 호출 AfxGetApp해야 합니다.

예시

//Print the current thread ID in the Debug Window
TRACE(_T("Current Thread ID = 0x%X\n"), AfxGetThread()->m_nThreadID);

요구 사항

머리글 afxwin.h

AfxInitRichEdit

이 함수를 호출하여 애플리케이션에 대한 서식 있는 편집 컨트롤(버전 1.0)을 초기화합니다.

BOOL AFXAPI AfxInitRichEdit();

설명

이 함수는 이전 버전과의 호환성을 위해 제공됩니다. 새 애플리케이션은 .를 사용해야 AfxInitRichEdit2합니다.

AfxInitRichEditRICHED32.DLL 를 로드하여 서식 있는 편집 컨트롤의 버전 1.0을 초기화합니다. 서식 있는 편집 컨트롤 RICHED20.DLL 의 버전 2.0 및 3.0을 사용하려면 로드해야 합니다. 를 호출하여 로드됩니다 AfxInitRichEdit2.

기존 Visual C++ 애플리케이션의 서식 있는 편집 컨트롤을 버전 2.0으로 업데이트하려면 을 엽니다. RC 파일을 텍스트로 사용하여 각 서식 있는 편집 컨트롤의 클래스 이름을 ""에서 "RICHEDITRichEdit20a"로 변경합니다. 그런 다음 호출 AfxInitRichEdit AfxInitRichEdit2을 .

또한 이 함수는 라이브러리가 프로세스에 대해 아직 초기화되지 않은 경우 공용 컨트롤 라이브러리를 초기화합니다. MFC 애플리케이션에서 직접 리치 편집 컨트롤을 사용하는 경우 MFC가 리치 편집 컨트롤 런타임을 제대로 초기화했는지 확인하기 위해 이 함수를 호출합니다. 또는 메서드를 Create CRichEditCtrlCRichEditViewCRichEditDoc호출하는 경우 일반적으로 이 함수를 호출할 필요가 없지만 경우에 따라 필요할 수 있습니다.

요구 사항

머리글 afxwin.h

AfxInitRichEdit2

이 함수를 호출하여 애플리케이션에 대한 다양한 편집 컨트롤(버전 2.0 이상)을 초기화합니다.

BOOL AFXAPI AfxInitRichEdit2();

설명

이 함수를 호출하여 서식 있는 편집 컨트롤의 버전 2.0을 로드 RICHED20.DLL 하고 초기화합니다. 또는 메서드를 Create CRichEditCtrlCRichEditViewCRichEditDoc호출하는 경우 일반적으로 이 함수를 호출할 필요가 없지만 경우에 따라 필요할 수 있습니다.

요구 사항

머리글 afxwin.h

AfxIsExtendedFrameClass

지정된 창이 확장된 프레임 개체인지 여부를 확인합니다.

구문

BOOL AFXAPI AfxIsExtendedFrameClass( CWnd* pWnd );

매개 변수

pWnd
[in] 에서 파생된 CWnd개체에 대한 포인터입니다.

Return Value

TRUE 제공된 창이 확장 프레임 개체이면 이고, 그렇지 않으면 FALSE.

설명

이 메서드는 TRUE 가 다음 클래스 중 하나에서 파생되는 경우 pWnd 를 반환합니다.

• CFrameWndEx

• CMDIFrameWndEx

• COleIPFrameWndEx

• COleDocIPFrameWndEx

• CMDIChildWndEx

이 메서드는 함수 또는 메서드 매개 변수가 확장된 프레임 창인지 확인해야 하는 경우에 유용합니다.

요구 사항

머리글: afxpriv.h

AfxIsMFCToolBar

지정된 창이 도구 모음 개체인지 여부를 확인합니다.

구문

BOOL AFXAPI AfxIsMFCToolBar(CWnd* pWnd);

매개 변수

pWnd
[in] 에서 파생된 CWnd개체에 대한 포인터입니다.

Return Value

TRUE 제공된 창이 도구 모음 개체이면 이고, 그렇지 않으면 FALSE.

설명

에서 파생된 경우 pWnd 이 메서드가 반환 TRUE 됩니다CMFCToolBar. 이 메서드는 함수 또는 메서드 매개 변수 CMFCToolBar 가 개체인지 확인해야 하는 경우에 유용합니다.

요구 사항

머리글: afxpriv.h

AfxKeyboardManager

전역 키보드 관리자에 대한 포인터입니다.

구문

CKeyboardManager* afxKeyboardManager;

요구 사항

머리글: afxkeyboardmanager.h

AfxLoadLibrary

AfxLoadLibrary를 사용해서 DLL 모듈을 매핑합니다.

HINSTANCE AFXAPI AfxLoadLibrary(LPCTSTR lpszModuleName);

매개 변수

lpszModuleName
모듈의 이름(.DLL 또는 .EXE 파일)이 포함된 null로 끝나는 문자열을 가리킵니다. 지정된 이름은 모듈의 파일 이름입니다.

문자열이 경로를 지정하지만 지정된 디렉터리에 파일이 없으면 함수가 실패합니다.

경로를 지정하지 않고 파일 이름 확장명은 생략하면 기본 확장명 .DLL 추가됩니다. 그러나 파일 이름 문자열에는 모듈 이름에 확장명 없음을 나타내는 후행 지점 문자(.)가 포함될 수 있습니다. 경로가 지정되지 않은 경우 함수는 데스크톱 애플리케이션에 대한 검색 순서를 사용합니다.

Return Value

함수가 성공하면 반환 값은 모듈에 대한 핸들입니다. 오류가 발생한 경우 반환 값은 .입니다 NULL.

설명

DLL 함수의 주소를 가져오는 데 사용할 수 있는 GetProcAddress 핸들을 반환합니다. AfxLoadLibrary 를 사용하여 다른 실행 모듈을 매핑할 수도 있습니다.

각 프로세스는 로드된 각 라이브러리 모듈에 대한 참조 수를 유지 관리합니다. 이 참조 수는 호출될 때마다 AfxLoadLibrary 증가하며 호출될 때마다 AfxFreeLibrary 감소됩니다. 참조 횟수가 0에 도달하면, 호출 프로세스의 주소 공간에서 모듈이 매핑 해제되고 핸들이 더 이상 유효하지 않습니다.

애플리케이션이 여러 스레드를 사용하는 AfxLoadLibrary 경우와 AfxFreeLibrary FreeLibraryMFC 확장 DLL을 동적으로 로드하는 경우 Win32 함수 LoadLibrary 대신 사용해야 합니다. MFC AfxLoadLibrary 확장 DLL이 로드되고 AfxFreeLibrary 언로드될 때 실행되는 시작 및 종료 코드가 전역 MFC 상태를 손상시키지 않도록 합니다.

애플리케이션에서 사용 AfxLoadLibrary 하려면 DLL 버전의 MFC에 동적으로 연결해야 합니다. 에 Afxdll_.h대한 AfxLoadLibrary헤더 파일은 MFC가 애플리케이션에 DLL로 연결된 경우에만 포함됩니다. MFC 확장 DLL을 사용하거나 만들려면 MFC의 DLL 버전에 연결해야 하기 때문에 이 요구 사항은 기본적으로 적용됩니다.

예시

// The following shows how to create a MDI based application
// using a generic CView derived class that is implemented in
// a dynamically loaded MFC Extension DLL.

typedef CRuntimeClass *(*GETDLLVIEW)();

BOOL CUserApp::InitInstance()
{
   // Standard Application Wizard generated initialization excluded.

// Register the application's document templates.  Document templates
//  serve as the connection between documents, frame windows and views

//Load MFC Extension DLL based view class.
m_hViewDll = AfxLoadLibrary(szMyViewDllPath);
if (!m_hViewDll)
{
   CString str;
   str.Format(_T("Error: Cannot find component %s"), szMyViewDllPath);
   AfxMessageBox(str);
   return FALSE;
}

GETDLLVIEW GetMyView = (GETDLLVIEW)GetProcAddress(m_hViewDll, "GetMyView");
ASSERT(GetMyView != NULL);

CMultiDocTemplate *pDocTemplate;
pDocTemplate = new CMultiDocTemplate(IDR_NVC_MFC_DLLUserTYPE,
                                     RUNTIME_CLASS(CUserDoc),
                                     RUNTIME_CLASS(CChildFrame), // custom MDI child frame
                                     GetMyView());
if (!pDocTemplate)
   return FALSE;
AddDocTemplate(pDocTemplate);

// Standard Application Wizard generated initialization excluded.

return TRUE;
}

int CUserApp::ExitInstance()
{
   if (NULL != m_hViewDll)
   {
      AfxFreeLibrary(m_hViewDll);
      m_hViewDll = NULL;
   }

   return CWinApp::ExitInstance();
}

요구 사항

머리글 afxdll_.h

AfxLoadLibraryEx

AfxLoadLibraryEx를 사용해서 DLL 모듈을 매핑합니다.

HINSTANCE AFXAPI AfxLoadLibraryEx(LPCTSTR lpFileName, HANDLE hFile, DWORD dwFlags);

매개 변수

lpFileName
모듈의 이름(.DLL 또는 .EXE 파일)이 포함된 null로 끝나는 문자열을 가리킵니다. 지정된 이름은 모듈의 파일 이름입니다.

문자열이 경로를 지정하지만 지정된 디렉터리에 파일이 없으면 함수가 실패합니다.

경로를 지정하지 않고 파일 이름 확장명은 생략하면 기본 확장명 .DLL 추가됩니다. 그러나 파일 이름 문자열에는 모듈 이름에 확장명 없음을 나타내는 후행 지점 문자(.)가 포함될 수 있습니다. 경로가 지정되지 않은 경우 함수는 데스크톱 애플리케이션에 대한 검색 순서를 사용합니다.

hFile
이 매개 변수는 나중에 사용하기 위해 예약되었습니다. NULL여야 합니다.

dwFlags
모듈을 로드할 때 수행할 작업입니다. 플래그를 지정하지 않으면 이 함수의 동작이 함수와 AfxLoadLibrary 동일합니다. 이 매개 변수의 가능한 값은 설명서에 LoadLibraryEx 설명되어 있습니다.

Return Value

함수가 성공하면 반환 값은 모듈에 대한 핸들입니다. 오류가 발생한 경우 반환 값은 .입니다 NULL.

설명

AfxLoadLibraryEx 는 DLL 함수의 주소를 가져오는 데 사용할 수 있는 GetProcAddress 핸들을 반환합니다. AfxLoadLibraryEx 를 사용하여 다른 실행 모듈을 매핑할 수도 있습니다.

각 프로세스는 로드된 각 라이브러리 모듈에 대한 참조 수를 유지 관리합니다. 이 참조 수는 호출될 때마다 AfxLoadLibraryEx 증가하며 호출될 때마다 AfxFreeLibrary 감소됩니다. 참조 횟수가 0에 도달하면, 호출 프로세스의 주소 공간에서 모듈이 매핑 해제되고 핸들이 더 이상 유효하지 않습니다.

애플리케이션에서 여러 스레드를 사용하고 AfxLoadLibraryEx AfxFreeLibrary MFC 확장 DLL을 동적으로 로드하는 경우 Win32 함수 LoadLibraryEx FreeLibrary대신 사용해야 합니다. MFC 확장 DLL이 로드되고 AfxFreeLibrary 언로드될 때 실행되는 시작 및 종료 코드가 전역 MFC 상태를 손상시키지 않도록 합니다AfxLoadLibraryEx.

애플리케이션에서 사용 AfxLoadLibraryEx 하려면 DLL 버전의 MFC에 동적으로 연결해야 합니다. 에 Afxdll_.h대한 AfxLoadLibraryEx헤더 파일은 MFC가 애플리케이션에 DLL로 연결된 경우에만 포함됩니다. MFC 확장 DLL을 사용하거나 만들려면 MFC의 DLL 버전에 연결해야 하기 때문에 이 요구 사항은 기본적으로 적용됩니다.

요구 사항

머리글 afxdll_.h

AfxMenuTearOffManager

전역 분리 메뉴 관리자에 대한 포인터입니다.

구문

CMenuTearOffManager* g_pTearOffMenuManager;

요구 사항

머리글: afxmenutearoffmanager.h

AfxMouseManager

전역 마우스 관리자에 대한 포인터입니다.

구문

CMouseManager* afxMouseManager;

요구 사항

머리글: afxmousemanager.h

AfxRegisterClass

이 함수를 사용하여 MFC를 사용하는 DLL에 창 클래스를 등록합니다.

BOOL AFXAPI AfxRegisterClass(WNDCLASS* lpWndClass);

매개 변수

lpWndClass
등록할 WNDCLASS 창 클래스에 대한 정보를 포함하는 구조체에 대한 포인터입니다. 이 구조에 대한 자세한 내용은 Windows SDK를 참조하세요.

Return Value

TRUE 클래스가 성공적으로 등록되면 FALSE.

설명

이 함수를 사용하는 경우 DLL이 언로드될 때 클래스의 등록이 자동으로 취소됩니다.

비 DLL 빌드 AfxRegisterClass 에서는 애플리케이션에 등록된 클래스가 자동으로 등록 취소되므로 식별자가 Windows 함수 RegisterClass에 매핑되는 매크로로 정의됩니다. 대신 RegisterClass사용하는 AfxRegisterClass 경우 애플리케이션과 DLL 모두에서 변경 없이 코드를 사용할 수 있습니다.

예시

// Register your unique class name that you wish to use
WNDCLASS wndcls;

memset(&wndcls, 0, sizeof(WNDCLASS));   // start with NULL defaults

wndcls.style = CS_DBLCLKS | CS_HREDRAW | CS_VREDRAW;

//you can specify your own window procedure
wndcls.lpfnWndProc = ::DefWindowProc; 
wndcls.hInstance = AfxGetInstanceHandle();
wndcls.hIcon = LoadIcon(wndcls.hInstance, MAKEINTRESOURCE(IDI_MYICON));
wndcls.hCursor = LoadCursor(wndcls.hInstance, MAKEINTRESOURCE(IDC_ARROW));
wndcls.hbrBackground = (HBRUSH)(COLOR_WINDOW + 1);
wndcls.lpszMenuName = NULL;

// Specify your own class name for using FindWindow later
wndcls.lpszClassName = _T("MyNewClass");

// Register the new class and trace if it fails
if(!AfxRegisterClass(&wndcls))
{
   TRACE("Class Registration Failed\n");
}

요구 사항

머리글 afxwin.h

AfxRegisterWndClass

사용자 고유의 창 클래스를 등록할 수 있습니다.

LPCTSTR AFXAPI AfxRegisterWndClass(
    UINT nClassStyle,
    HCURSOR hCursor = 0,
    HBRUSH hbrBackground = 0,
    HICON hIcon = 0);

매개 변수

nClassStyle
창 클래스에 대해 비트 OR(|) 연산자를 사용하여 만든 Windows 클래스 스타일 또는 스타일 조합을 지정합니다. 클래스 스타일 목록은 Windows SDK의 WNDCLASS 구조를 참조하세요. 이 경우 NULL기본값은 다음과 같이 설정됩니다.

• 마우스 스타일을 설정하여 사용자가 마우스를 CS_DBLCLKS두 번 클릭할 때 창 프로시저에 두 번 클릭 메시지를 보냅니다.

• 화살표 커서 스타일을 Windows 표준 IDC_ARROW으로 설정합니다.

• 배경 브러시를 설정하므로 NULL창에서 배경이 지워지지 않습니다.

• 아이콘을 표준 물결표 Windows 로고 아이콘으로 설정합니다.

hCursor
창 클래스에서 만든 각 창에 설치할 커서 리소스에 대한 핸들을 지정합니다. 기본값 인 0을 사용하면 표준 IDC_ARROW 커서가 표시됩니다.

hbrBackground
창 클래스에서 만든 각 창에 설치할 브러시 리소스에 대한 핸들을 지정합니다. 기본값 인 0을 사용하는 경우 배경 브러시가 NULL 있으며, 기본적으로 창은 처리하는 WM_ERASEBKGND동안 해당 배경을 지우지 않습니다.

hIcon
창 클래스에서 만든 각 창에 설치할 아이콘 리소스에 대한 핸들을 지정합니다. 기본값 인 0을 사용하면 표준 물결표 Windows 로고 아이콘이 표시됩니다.

Return Value

클래스 이름을 포함하는 null로 끝나는 문자열입니다. 이 클래스 이름을 멤버 함수 또는 Create 다른 **CWnd-**파생 클래스에 CWnd 전달하여 창을 만들 수 있습니다. 이름은 Microsoft Foundation 클래스 라이브러리에 의해 생성됩니다.

참고 항목

반환 값은 정적 버퍼에 대한 포인터입니다. 이 문자열을 저장하려면 변수에 CString 할당합니다.

설명

Microsoft Foundation 클래스 라이브러리는 몇 가지 표준 창 클래스를 자동으로 등록합니다. 고유한 창 클래스를 등록하려면 이 함수를 호출합니다.

클래스에 AfxRegisterWndClass 등록된 이름은 매개 변수에만 따라 달라집니다. 동일한 매개 변수를 사용하여 여러 번 호출 AfxRegisterWndClass 하는 경우 첫 번째 호출에서만 클래스를 등록합니다. 나중에 동일한 매개 변수를 사용하여 AfxRegisterWndClass 호출하면 이미 등록된 클래스 이름이 반환됩니다.

각 클래스에 대해 별도의 창 클래스를 가져오는 대신 동일한 매개 변수를 사용하여 여러 CWnd파생 클래스를 호출 AfxRegisterWndClass 하는 경우 각 클래스는 동일한 창 클래스를 공유합니다. 이 공유는 클래스 스타일을 사용하는 경우 CS_CLASSDC 문제를 일으킬 수 있습니다. 여러 CS_CLASSDC 창 클래스 대신 하나의 창 클래스로 CS_CLASSDC 끝납니다. 해당 클래스를 사용하는 모든 C++ 창은 동일한 DC를 공유합니다. 이 문제를 방지하려면 클래스를 등록하도록 호출 AfxRegisterClass 합니다.

창 클래스 등록 및 함수에 대한 자세한 내용은 기술 참고 TN001: Window 클래스 등록을 AfxRegisterWndClass 참조하세요.

예시

CString strMyClass;

// load stock cursor, brush, and icon for
// my own window class

try
{
   strMyClass = AfxRegisterWndClass(
       CS_VREDRAW | CS_HREDRAW,
       ::LoadCursor(NULL, IDC_ARROW),
       (HBRUSH)::GetStockObject(WHITE_BRUSH),
       ::LoadIcon(NULL, IDI_APPLICATION));
}
catch (CResourceException *pEx)
{
   AfxMessageBox(_T("Couldn't register class! (Already registered?)"));
   pEx->Delete();
}

요구 사항

머리글 afxwin.h

AfxSetPerUserRegistration

애플리케이션이 (HKCU) 노드에 대한 레지스트리 액세스를 HKEY_CURRENT_USER 리디렉션하는지 여부를 설정합니다.

void AFXAPI AfxSetPerUserRegistration(BOOL bEnable);

매개 변수

bEnable
[in] TRUE 는 레지스트리 정보가 노드로 전달됨을 HKCU 나타냅니다. FALSE 는 애플리케이션이 기본 노드에 레지스트리 정보를 씁니다. 기본 노드는 (HKCR)입니다 HKEY_CLASSES_ROOT .

설명

Windows Vista 이전에는 레지스트리에 액세스한 애플리케이션에서 일반적으로 노드를 사용했습니다 HKEY_CLASSES_ROOT . 그러나 Windows Vista 이상 운영 체제에서는 관리자 권한 모드로 애플리케이션을 실행하여 을 작성 HKCR해야 합니다.

이 메서드를 사용하면 애플리케이션이 관리자 모드에서 실행하지 않고도 레지스트리를 읽고 쓸 수 있습니다. 레지스트리 액세스를 .로 HKCR 리디렉션하여 작동합니다 HKCU. 자세한 내용은 Linker Property Pages을 참조하세요.

레지스트리 리디렉션을 사용하도록 설정하면 프레임워크가 액세스를 .로 HKCR HKEY_CURRENT_USER\Software\Classes리디렉션합니다. MFC 및 ATL 프레임워크만 리디렉션의 영향을 받습니다.

기본 구현은 아래 HKCR의 레지스트리에 액세스합니다.

요구 사항

머리글 afxstat_.h

AfxSetResourceHandle

이 함수를 사용하여 애플리케이션의 HINSTANCE 기본 리소스가 로드되는 위치를 결정하는 핸들을 설정합니다.

void AFXAPI AfxSetResourceHandle(HINSTANCE hInstResource);

매개 변수

hInstResource
애플리케이션의 리소스가 로드되는 .EXE 또는 DLL 파일에 대한 인스턴스 또는 모듈 핸들입니다.

예시

// This code is taken from CMyApp::InitInstance
HINSTANCE hRes = NULL;
hRes = LoadLibrary(_T("Resource.dll"));
if (hRes)
   AfxSetResourceHandle(hRes);

요구 사항

머리글 afxwin.h

AfxShellManager

전역 셸 관리자에 대한 포인터입니다.

구문

CShellManager* afxShellManager;

요구 사항

머리글: afxshellmanager.h

AfxSocketInit

재정의에서 CWinApp::InitInstance 이 함수를 호출하여 Windows 소켓을 초기화합니다.

BOOL AfxSocketInit(WSADATA* lpwsaData = NULL);

매개 변수

lpwsaData
구조체에 대한 포인터입니다 WSADATA . lpwsaData 같지 NULL않으면 구조체의 WSADATA 주소가 호출에 WSAStartup의해 채워집니다. 또한 이 함수는 애플리케이션이 WSACleanup 종료되기 전에 호출되도록 합니다.

Return Value

함수가 성공하면 0이 아니고 그렇지 않으면 0입니다.

설명

정적으로 연결된 MFC 애플리케이션의 보조 스레드에서 MFC 소켓을 사용하는 경우 소켓을 사용하여 소켓 라이브러리를 초기화하는 각 스레드에서 호출 AfxSocketInit 해야 합니다. 기본적으로 AfxSocketInit 기본 스레드에서만 호출됩니다.

요구 사항

머리글 afxsock.h

AfxUserToolsManager

전역 사용자 도구 관리자에 대한 포인터입니다.

구문

CUserToolsManager* afxUserToolsManager;

요구 사항

머리글: afxusertoolsmanager.h

AfxWinInit

이 함수는 MFC를 초기화하기 위해 GUI 기반 애플리케이션 초기화의 CWinApp 일부로 MFC 제공 WinMain 함수에 의해 호출됩니다.

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

매개 변수

hInstance
현재 실행 중인 모듈의 핸들입니다.

hPrevInstance
애플리케이션의 이전 인스턴스에 대한 핸들입니다. Win32 기반 애플리케이션의 경우 이 매개 변수는 항상 NULL.

lpCmdLine
애플리케이션의 명령줄을 지정하는 null로 끝나는 문자열을 가리킵니다.

nCmdShow
GUI 애플리케이션의 주 창을 표시하는 방법을 지정합니다.

설명

MFC 제공 WinMain 함수를 사용하지 않는 콘솔 애플리케이션의 경우 MFC를 초기화하기 위해 직접 호출 AfxWinInit 해야 합니다.

자신을 호출 AfxWinInit 하는 경우 클래스의 CWinApp 인스턴스를 선언해야 합니다. 콘솔 애플리케이션의 경우 고유한 클래스 CWinApp 를 파생하지 않고 대신 직접 인스턴스 CWinApp 를 사용하도록 선택할 수 있습니다. 이 기술은 애플리케이션의 모든 기능을 구현에 그대로 두기로 결정한 경우에 적합합니다 main.

참고 항목

어셈블리에 대한 활성화 컨텍스트를 만들 때 MFC는 사용자 모듈에서 제공하는 매니페스트 리소스를 사용합니다. 활성화 컨텍스트는 AfxWinInit에서 만듭니다. 자세한 내용은 MFC 모듈 상태의 활성화 컨텍스트 지원을 참조하세요.

예시

#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;
}

요구 사항

머리글 afxwin.h

참고 항목

매크로 및 전역
CWinApp 클래스
CContextMenuManager 클래스
CWnd 클래스
CFrameWndEx 클래스
CMFCToolBar 클래스
CKeyboardManager 클래스
CMenuTearOffManager 클래스
CMouseManager 클래스
CShellManager 클래스
CUserToolsManager 클래스