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

Consulte también

CreateILockBytesOnHGlobal

StgOpenStorage