Share via

WriteProcessMemory 함수(memoryapi.h)

  • 아티클

지정된 프로세스의 메모리 영역에 데이터를 씁니다. 쓸 전체 영역에 액세스할 수 있어야 합니다. 그렇지 않으면 작업이 실패합니다.

구문

BOOL WriteProcessMemory(
  [in]  HANDLE  hProcess,
  [in]  LPVOID  lpBaseAddress,
  [in]  LPCVOID lpBuffer,
  [in]  SIZE_T  nSize,
  [out] SIZE_T  *lpNumberOfBytesWritten
);

매개 변수

[in] hProcess

수정할 프로세스 메모리에 대한 핸들입니다. 핸들에는 프로세스에 대한 PROCESS_VM_WRITE 및 PROCESS_VM_OPERATION 액세스 권한이 있어야 합니다.

[in] lpBaseAddress

데이터가 기록되는 지정된 프로세스의 기본 주소에 대한 포인터입니다. 데이터 전송이 발생하기 전에 시스템은 지정된 크기의 기본 주소 및 메모리에 있는 모든 데이터에 쓰기 액세스에 액세스할 수 있는지 확인하고 액세스할 수 없는 경우 함수가 실패합니다.

[in] lpBuffer

지정된 프로세스의 주소 공간에 쓸 데이터가 포함된 버퍼에 대한 포인터입니다.

[in] nSize

지정된 프로세스에 쓸 바이트 수입니다.

[out] lpNumberOfBytesWritten

지정된 프로세스로 전송된 바이트 수를 수신하는 변수에 대한 포인터입니다. 이 매개 변수는 선택 사항입니다. lpNumberOfBytesWritten가 NULL이면 매개 변수가 무시됩니다.

반환 값

함수가 성공하면 반환 값이 0이 아닙니다.

함수가 실패하면 반환 값은 0입니다. 확장 오류 정보를 가져오려면 GetLastError를 호출합니다. 요청된 쓰기 작업이 액세스할 수 없는 프로세스 영역으로 넘어가면 함수가 실패합니다.

설명

WriteProcessMemory 는 현재 프로세스의 지정된 버퍼에서 지정된 프로세스의 주소 범위로 데이터를 복사합니다. PROCESS_VM_WRITE PROCESS_VM_OPERATION 액세스할 수 있는 핸들이 있는 프로세스는 함수를 호출할 수 있습니다. 일반적으로 항상 그렇지는 않지만 기록되는 주소 공간이 있는 프로세스는 디버그되고 있습니다.

쓸 전체 영역에 액세스할 수 있어야 하며 액세스할 수 없는 경우 함수가 실패합니다.

요구 사항

   
지원되는 최소 클라이언트 Windows XP [데스크톱 앱만 해당]
지원되는 최소 서버 Windows Server 2003 [데스크톱 앱만 해당]
대상 플랫폼 Windows
헤더 memoryapi.h(Windows.h 포함)
라이브러리 onecore.lib
DLL Kernel32.dll

참고 항목

디버깅 함수

디버깅을 위한 프로세스 함수

ReadProcessMemory

VirtualAllocEx