Função GetHGlobalFromILockBytes (coml2api.h)

  • Artigo

A função GetHGlobalFromILockBytes recupera um identificador de memória global para um objeto de matriz de bytes criado usando a função CreateILockBytesOnHGlobal .

Sintaxe

HRESULT GetHGlobalFromILockBytes(
  [in]  LPLOCKBYTES plkbyt,
  [out] HGLOBAL     *phglobal
);

Parâmetros

[in] plkbyt

Ponteiro para a interface ILockBytes no objeto byte-array criado anteriormente por uma chamada para a função CreateILockBytesOnHGlobal .

[out] phglobal

Ponteiro para o identificador de memória atual usado pelo objeto byte-array especificado.

Retornar valor

Essa função retorna HRESULT.

Comentários

Após uma chamada para CreateILockBytesOnHGlobal, que cria um objeto de matriz de bytes na memória global, GetHGlobalFromILockBytes recupera um ponteiro para o identificador da memória global subjacente ao objeto de matriz de bytes. O identificador que essa função retorna pode ser diferente do identificador original devido a chamadas intervindo para a função GlobalReAlloc .

O conteúdo do identificador de memória retornado pode ser gravado em um arquivo de disco limpo e, em seguida, aberto como um objeto de armazenamento usando a função StgOpenStorage.

Essa função só funciona no mesmo processo do qual a matriz de bytes foi criada.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 2000 Professional [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte Windows 2000 Server [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino Windows
Cabeçalho coml2api.h (inclua Ole2.h)
Biblioteca Ole32.lib
DLL Ole32.dll

Confira também

CreateILockBytesOnHGlobal

Stgopenstorage