Función LocalHandle (winbase.h)
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 |