GetHGlobalFromILockBytes 함수(coml2api.h)
GetHGlobalFromILockBytes 함수는 CreateILockBytesOnHGlobal 함수를 사용하여 만든 바이트 배열 개체에 대한 전역 메모리 핸들을 검색합니다.
구문
HRESULT GetHGlobalFromILockBytes(
[in] LPLOCKBYTES plkbyt,
[out] HGLOBAL *phglobal
);
매개 변수
[in] plkbyt
CreateILockBytesOnHGlobal 함수를 호출하여 이전에 만든 바이트 배열 개체의 ILockBytes 인터페이스에 대한 포인터입니다.
[out] phglobal
지정된 바이트 배열 개체에서 사용하는 현재 메모리 핸들에 대한 포인터입니다.
반환 값
이 함수는 HRESULT를 반환합니다.
설명
전역 메모리에 바이트 배열 개체를 만드는 CreateILockBytesOnHGlobal을 호출한 후 GetHGlobalFromILockBytes 는 바이트 배열 개체를 기반으로 하는 전역 메모리의 핸들에 대한 포인터를 검색합니다. 이 함수가 반환하는 핸들은 GlobalReAlloc 함수에 대한 중간 호출로 인해 원래 핸들과 다를 수 있습니다.
반환된 메모리 핸들의 내용을 클린 디스크 파일에 쓴 다음 StgOpenStorage 함수를 사용하여 스토리지 개체로 열 수 있습니다.
이 함수는 바이트 배열이 만들어진 동일한 프로세스 내에서만 작동합니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 2000 Professional [데스크톱 앱 | UWP 앱] |
| 지원되는 최소 서버 | Windows 2000 Server [데스크톱 앱 | UWP 앱] |
| 대상 플랫폼 | Windows |
| 헤더 | coml2api.h(Ole2.h 포함) |
| 라이브러리 | Ole32.lib |
| DLL | Ole32.dll |