Función LocalHandle (winbase.h)

  • Artículo

Recupera el identificador asociado al puntero especificado a un objeto de memoria local.

Nota Las funciones locales 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 local. Para obtener más información, vea Funciones globales y locales.
 

Sintaxis

HLOCAL LocalHandle(
  [in] LPCVOID pMem
);

Parámetros

[in] pMem

Puntero al primer byte del objeto de memoria local. La función LocalLock devuelve este puntero.

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto es un identificador para el objeto de memoria local 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 LocalAlloc asigna un objeto de memoria local con LMEM_MOVEABLE, devuelve un identificador al objeto . La función LocalLock convierte este identificador en un puntero al bloque de memoria del objeto y LocalHandle vuelve a convertir el puntero 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 (incluya Windows.h)
Library Kernel32.lib
Archivo DLL Kernel32.dll

Vea también

Funciones globales y locales

LocalAlloc

LocalLock

Funciones de administración de memoria