Função InternalGetWindowText (winuser.h)

Artigo
08/27/2023

[Essa função não se destina ao uso geral. Ele pode estar alterado ou indisponível nas versões subsequentes do Windows.]

Copia o texto da barra de título da janela especificada (se tiver um) em um buffer.

Essa função é semelhante à função GetWindowText . No entanto, ele obtém o texto da janela diretamente da estrutura da janela associada ao identificador da janela especificada e sempre fornece o texto como uma cadeia de caracteres Unicode. Isso é diferente de GetWindowText , que obtém o texto enviando à janela uma mensagem WM_GETTEXT . Se a janela especificada for um controle, o texto do controle será obtido.

Sintaxe

int InternalGetWindowText(
  [in]  HWND   hWnd,
  [out] LPWSTR pString,
  [in]  int    cchMaxCount
);

Parâmetros

[in] hWnd

Digite: HWND

Um identificador para a janela ou controle que contém o texto.

[out] pString

Tipo: LPWSTR

O buffer que deve receber o texto.

Se a cadeia de caracteres for longa ou maior que o buffer, a cadeia de caracteres será truncada e terminada com um caractere nulo.

[in] cchMaxCount

Tipo: int

O número máximo de caracteres a serem copiados para o buffer, incluindo o caractere nulo. Se o texto exceder esse limite, ele será truncado.

Retornar valor

Tipo: int

Se a função for bem-sucedida, o valor retornado será o comprimento, em caracteres, da cadeia de caracteres copiada, sem incluir o caractere nulo de terminação.

Se a janela não tiver nenhuma barra de título ou texto, se a barra de título estiver vazia ou se a janela ou o identificador de controle for inválido, o valor retornado será zero. Para obter informações de erro estendidas, chame GetLastError.

Comentários

Essa função não foi incluída nos cabeçalhos e bibliotecas do SDK até o Windows XP com o Service Pack 1 (SP1) e o Windows Server 2003. Se você não tiver um arquivo de cabeçalho e uma biblioteca de importação para essa função, poderá chamar a função usando LoadLibrary e GetProcAddress.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	winuser.h (inclua Windows.h)
Biblioteca	User32.lib
DLL	User32.dll