Función GetHGlobalFromILockBytes (coml2api.h)
La función GetHGlobalFromILockBytes recupera un identificador de memoria global en un objeto de matriz de bytes creado mediante la función CreateILockBytesOnHGlobal .
Sintaxis
HRESULT GetHGlobalFromILockBytes(
[in] LPLOCKBYTES plkbyt,
[out] HGLOBAL *phglobal
);
Parámetros
[in] plkbyt
Puntero a la interfaz ILockBytes en el objeto byte-array creado anteriormente por una llamada a la función CreateILockBytesOnHGlobal .
[out] phglobal
Puntero al identificador de memoria actual utilizado por el objeto de matriz de bytes especificado.
Valor devuelto
Esta función devuelve HRESULT.
Comentarios
Después de una llamada a CreateILockBytesOnHGlobal, que crea un objeto de matriz de bytes en la memoria global, GetHGlobalFromILockBytes recupera un puntero al identificador de la memoria global subyacente al objeto de matriz de bytes. El identificador que devuelve esta función puede ser diferente del identificador original debido a llamadas intermedias a la función GlobalReAlloc .
El contenido del identificador de memoria devuelto se puede escribir en un archivo de disco limpio y, a continuación, abrirlo como un objeto de almacenamiento mediante la función StgOpenStorage .
Esta función solo funciona dentro del mismo proceso desde el que se creó la matriz de bytes.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows 2000 Professional [aplicaciones de escritorio | Aplicaciones para UWP] |
| Servidor mínimo compatible | Windows 2000 Server [aplicaciones de escritorio | Aplicaciones para UWP] |
| Plataforma de destino | Windows |
| Encabezado | coml2api.h (include Ole2.h) |
| Library | Ole32.lib |
| Archivo DLL | Ole32.dll |