GetMappedFileName

The GetMappedFileName function checks if the specified address is within a memory-mapped file in the address space of the specified process. If so, the function returns the name of the memory-mapped file.

DWORD GetMappedFileName(
  HANDLE hProcess,    // handle to process
  LPVOID lpv,         // address to verify
  LPTSTR lpFilename,  // file name buffer
  DWORD nSize         // size of buffer
);

Parameters

hProcess

[in] Handle to the process.

lpv

[in] Specifies the address to verify.

lpFilename

[out] Pointer to the buffer that receives the name of the memory-mapped file to which the address specified by lpv belongs.

nSize

[in] Specifies the size, in bytes, of the lpFilename buffer.

Return Value

If the function succeeds, the return value specifies the length of the string copied to the buffer.

If the function fails, the return value is zero. To get extended error information, call GetLastError.

Requirements

  Windows NT/2000: Requires Windows NT 4.0 or later.
  Header: Declared in Psapi.h.
  Library: Use Psapi.lib.
  Unicode: Implemented as Unicode and ANSI versions on Windows NT/2000.

See Also

Process Status Helper Overview, PSAPI Functions, EnumProcesses