GetMappedFileNameA 함수(psapi.h)

지정된 주소가 지정된 프로세스의 주소 공간에서 메모리 매핑된 파일 내에 있는지 여부를 확인합니다. 이 경우 함수는 메모리 매핑된 파일의 이름을 반환합니다.

통사론

DWORD GetMappedFileNameA(
  [in]  HANDLE hProcess,
  [in]  LPVOID lpv,
  [out] LPSTR  lpFilename,
  [in]  DWORD  nSize
);

매개 변수

[in] hProcess

프로세스에 대한 핸들입니다. 핸들에 PROCESS_QUERY_INFORMATION 액세스 권한이 있어야 합니다. 자세한 내용은 프로세스 보안 및 액세스 권한참조하세요.

[in] lpv

확인할 주소입니다.

[out] lpFilename

lpv 지정된 주소가 속한 메모리 매핑 파일의 이름을 받는 버퍼에 대한 포인터입니다.

[in] nSize

lpFilename 버퍼의 크기(문자)입니다.

반환 값

함수가 성공하면 반환 값은 버퍼에 복사된 문자열의 길이를 문자 단위로 지정합니다.

함수가 실패하면 반환 값은 0입니다. 확장 오류 정보를 얻으려면 GetLastError호출합니다.

발언

Windows 7 및 Windows Server 2008 R2부터 Psapi.h는 PSAPI 함수에 대한 버전 번호를 설정합니다. PSAPI 버전 번호는 함수를 호출하는 데 사용되는 이름과 프로그램이 로드해야 하는 라이브러리에 영향을 줍니다.

PSAPI_VERSION 2 이상인 경우 이 함수는 Psapi.h에서 K32GetMappedFileName 정의되고 Kernel32.lib 및 Kernel32.dll내보냅니다. PSAPI_VERSION 1이면 이 함수는 Psapi.h의 GetMappedFileName 정의되고 Psapi.lib에서 내보내고 Psapi.dll K32GetMappedFileName호출하는 래퍼로 내보냅니다.

이전 버전의 Windows 및 Windows 7 이상 버전에서 실행해야 하는 프로그램은 항상 이 함수를 GetMappedFileName호출해야 합니다. 기호의 올바른 해상도를 보장하려면 TARGETLIBS 매크로에 Psapi.lib를 추가하고 -DPSAPI_VERSION=1사용하여 프로그램을 컴파일합니다. 런타임 동적 연결을 사용하려면 Psapi.dll로드합니다.

Windows Server 2012에서 이 함수는 다음 기술에서 지원됩니다.

예제

예를 들어 파일 핸들파일 이름 가져오기 참조하세요.

요구 사항

참고 항목

EnumProcesses

Memory-Mapped 파일 정보

PSAPI 함수