LockResource 함수(libloaderapi.h)
메모리에서 지정된 리소스에 대한 포인터를 검색합니다.
구문
LPVOID LockResource(
[in] HGLOBAL hResData
);
매개 변수
[in] hResData
형식: HGLOBAL
액세스할 리소스에 대한 핸들입니다. LoadResource 함수는 이 핸들을 반환합니다. 이 매개 변수는 이전 버전과의 호환성을 위해서만 HGLOBAL 변수로 나열됩니다. LoadResource 함수에서 성공한 반환 값 이외의 값을 매개 변수로 전달하지 마세요.
반환 값
형식: LPVOID
로드된 리소스를 사용할 수 있는 경우 반환 값은 리소스의 첫 번째 바이트에 대한 포인터입니다. 그렇지 않으면 NULL입니다.
설명
LockResource에서 반환된 포인터는 리소스가 포함된 모듈이 언로드될 때까지 유효합니다. 리소스를 만든 프로세스가 종료되면 시스템에서 리소스를 자동으로 삭제하므로 리소스의 잠금을 해제할 필요가 없습니다.
FindResourceA 함수 또는 FindResourceExA 함수에서 반환된 핸들을 사용하여 리소스를 잠그지 마세요. 이러한 핸들은 임의 데이터를 가리킵니다.
참고
LockResource 는 실제로 메모리를 잠그지 않습니다. 리소스 데이터가 포함된 메모리에 대한 포인터를 가져오는 데만 사용됩니다. 함수의 이름은 LoadResource에서 할당한 전역 메모리 블록을 잠그는 데 사용된 Windows XP 이전 버전에서 가져옵니다.
예제
예제는 리소스 업데이트를 참조하세요.
요구 사항
| 지원되는 최소 클라이언트 | Windows 2000 Professional[데스크톱 앱만] |
| 지원되는 최소 서버 | Windows 2000 Server[데스크톱 앱만] |
| 대상 플랫폼 | Windows |
| 헤더 | libloaderapi.h(Windows.h 포함) |
| 라이브러리 | Kernel32.lib |
| DLL | Kernel32.dll |