winbase.h


LocalHandle

La función LocalHandle recupera el manipulador asociado con el puntero a un objeto de memoria local especificado.

Sintaxis

HLOCAL LocalHandle(
    LPCVOID pMem  // dirección del objeto de memoria local 
   );

Parámetros:

pMem: apinta al primer byte del objeto de memoria local. Este puntero es devuelto por la función LocalLock.

Valor de retorno

Si la función tiene éxito, el valor de retorno es el manipulador del objeto de memoria especificado.

Si la función falla, el valor de retorno es NULL. Para obtener información más detallada sobre el error, llamar a la función GetLastError.

Observaciones

Cuando la función LocalAlloc reserva un objeto de memoria local con la bandera LMEM_MOVEABLE, devuelve el manipulador del objeto. La función LocalLock convierte este manipulador en un puntero al bloque de memoria del objeto, y LocalHandle convierte de nuevo el puntero en un manipulador.