Função GetHGlobalFromILockBytes (coml2api.h)
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 |