Función GlobalHandle (winbase.h)

  • Artículo

Recupera el identificador asociado al puntero especificado a un bloque de memoria global.

Nota Las funciones globales tienen mayor sobrecarga y proporcionan menos características que otras funciones de administración de memoria. Las nuevas aplicaciones deben usar las funciones del montón a menos que la documentación indique que se debe usar una función global. Para obtener más información, vea Funciones globales y locales.
 

Sintaxis

HGLOBAL GlobalHandle(
  [in] LPCVOID pMem
);

Parámetros

[in] pMem

Puntero al primer byte del bloque de memoria global. La función GlobalLock devuelve este puntero.

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto es un identificador para el objeto de memoria global especificado.

Si la función no se realiza correctamente, el valor devuelto es NULL. Para obtener información de error extendida, llame a GetLastError.

Comentarios

Cuando la función GlobalAlloc asigna un objeto de memoria con GMEM_MOVEABLE, devuelve un identificador al objeto . La función GlobalLock convierte este identificador en un puntero al bloque de memoria y GlobalHandle convierte el puntero de nuevo en un identificador.

Requisitos

Requisito Value
Cliente mínimo compatible Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado winbase.h (incluye Windows.h)
Library Kernel32.lib
Archivo DLL Kernel32.dll

Vea también

Funciones globales y locales

GlobalAlloc

GlobalLock

Funciones de administración de memoria