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 |