GetModuleFileName(A)

GetModuleFileName(A)

지정된 모듈을 포함한 실행 가능 파일의, 풀 패스명과 파일명을 취득합니다.

DWORD GetModuleFileNameA(
    HMODULE  hModule,    // 모듈 핸들
    PTSTR    pFilename,  // 버퍼 주소
    DWORD    nSize       // 버퍼의 사이즈
);

KERNEL32.DLL

인수

hModule

모듈의 핸들을 지정합니다.이 모듈을 포함한 실행 가능 파일의 파일명이 풀 패스로 취득됩니다.

0 (NULL) (을)를 지정하면, 호출측 프로세스를 작성하기 위해서 사용된 모듈의 패스를 취득합니다.

pFilename

모듈의 파일명을 격납하기 위한 버퍼의 주소를 지정합니다.

nSize

pFilename 파라미터로 나타나는 버퍼의 사이즈를 아르바이트 단위(Unicode 판의 경우는 문자수)로 지정합니다.사이즈가 부족했던 경우, 초과 분의 문자는 잘라 버릴 수 있습니다.

반환값

성공했을 경우는 버퍼에 카피된 문자열의 길이가 아르바이트 단위(Unicode 판의 경우는 문자수)로 돌아갑니다.

실패했을 경우는 0 하지만 돌아갑니다.확장 에러 정보를 취득하려면 , GetLastError 함수를 사용합니다.

해설

Windows 95/98/Me: 어플리케이션 내부의 버젼이4.00이상 때, 한편, 긴 파일명이 이용 가능한 때는, 긴 파일명을 취득합니다.그렇지 않은 경우는,DOS형식(8.3형식)의 파일명을 취득합니다.

대응 정보

Windows 95 이후 / Windows NT 3.1 이후