mensaje de EM_GETHANDLE

Obtiene un identificador de la memoria asignada actualmente para el texto de un control de edición multilínea.

Parámetros

wParam

No se utiliza; debe ser cero.

lParam

No se utiliza; debe ser cero.

Valor devuelto

El valor devuelto es un identificador de memoria que identifica el búfer que contiene el contenido del control de edición. Si se produce un error, como enviar el mensaje a un control de edición de una sola línea, el valor devuelto es cero.

Comentarios

Si la función se ejecuta correctamente, la aplicación puede acceder al contenido del control de edición mediante la conversión del valor devuelto a HLOCAL y pasarlo a LocalLock. LocalLock devuelve un puntero a un búfer que es una matriz terminada en null de CHARs o WCHARs, dependiendo de si una función ANSI o Unicode creó el control. Por ejemplo, si se usó CreateWindowExA , el búfer es una matriz de CHARs, pero si se usó CreateWindowExW , el búfer es una matriz de WCHARs. Es posible que la aplicación no cambie el contenido del búfer. Para desbloquear el búfer, la aplicación llama a LocalUnlock antes de permitir que el control de edición reciba nuevos mensajes.

Nota

Para Comctl32.dll versión 6, el búfer siempre contiene una matriz de WCHARs, independientemente de si una función ANSI o Unicode creó el control de edición. Para obtener más información sobre las versiones dll, consulte Versiones de control comunes.

Si la aplicación no puede cumplir las restricciones impuestas por EM_GETHANDLE, use las funciones GetWindowTextLength y GetWindowText para copiar el contenido del control de edición en un búfer proporcionado por la aplicación.

Edición enriquecida: No se admite el mensaje EM_GETHANDLE . Los controles de edición enriquecidos no almacenan texto como una simple matriz de caracteres.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Encabezado	Winuser.h (incluye Windows.h)

Consulte también

Referencia

EM_SETHANDLE

Otros recursos

GetWindowText

GetWindowTextLength

LocalLock

LocalUnlock