Función InternalGetWindowText (winuser.h)
[Esta función no está pensada para uso general. Puede modificarse o no estar disponible en versiones posteriores de Windows.
Copia el texto de la barra de título de la ventana especificada (si tiene una) en un búfer.
Esta función es similar a la función GetWindowText . Sin embargo, obtiene el texto de la ventana directamente desde la estructura de ventana asociada al identificador de la ventana especificada y, a continuación, siempre proporciona el texto como una cadena Unicode. Esto es a diferencia de GetWindowText que obtiene el texto enviando a la ventana un mensaje de WM_GETTEXT . Si la ventana especificada es un control, se obtiene el texto del control.
Sintaxis
int InternalGetWindowText(
[in] HWND hWnd,
[out] LPWSTR pString,
[in] int cchMaxCount
);
Parámetros
[in] hWnd
Tipo: HWND
Identificador de la ventana o control que contiene el texto.
[out] pString
Tipo: LPWSTR
Búfer que va a recibir el texto.
Si la cadena es tan larga o más larga que el búfer, la cadena se trunca y finaliza con un carácter NULO.
[in] cchMaxCount
Tipo: int
Número máximo de caracteres que se van a copiar en el búfer, incluido el carácter NULL. Si el texto supera este límite, se trunca.
Valor devuelto
Tipo: int
Si la función se ejecuta correctamente, el valor devuelto es la longitud, en caracteres, de la cadena copiada, sin incluir el carácter nulo de terminación.
Si la ventana no tiene ninguna barra de título o texto, si la barra de título está vacía o si la ventana o el identificador de control no son válidos, el valor devuelto es cero. Para obtener información de error extendida, llame a GetLastError.
Comentarios
Esta función no se incluyó en los encabezados y bibliotecas del SDK hasta Windows XP con Service Pack 1 (SP1) y Windows Server 2003. Si no tiene un archivo de encabezado y una biblioteca de importación para esta función, puede llamar a la función mediante LoadLibrary y GetProcAddress.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows 2000 Professional [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows 2000 Server [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | winuser.h (incluya Windows.h) |
| Library | User32.lib |
| Archivo DLL | User32.dll |
Consulte también
Conceptual
Referencia