Função GetWindowLongPtrA (winuser.h)

Artigo
08/27/2023

Recupera informações sobre a janela especificada. A função também recupera o valor em um deslocamento especificado na memória extra da janela.

Nota Para escrever código compatível com versões de 32 bits e 64 bits do Windows, use GetWindowLongPtr. Ao compilar para Windows de 32 bits, GetWindowLongPtr é definido como uma chamada para a função GetWindowLong .

Sintaxe

LONG_PTR GetWindowLongPtrA(
  [in] HWND hWnd,
  [in] int  nIndex
);

Parâmetros

[in] hWnd

Digite: HWND

Um identificador para a janela e, indiretamente, a classe à qual a janela pertence.

[in] nIndex

Tipo: int

O deslocamento baseado em zero para o valor a ser recuperado. Os valores válidos estão no intervalo zero até o número de bytes de memória de janela extra, menos o tamanho de um LONG_PTR. Para recuperar qualquer outro valor, especifique um dos valores a seguir.

Valor	Significado
GWL_EXSTYLE -20	Recupera os estilos de janela estendidos.
GWLP_HINSTANCE -6	Recupera um identificador para a instância do aplicativo.
GWLP_HWNDPARENT -8	Recupera um identificador para a janela pai, se houver um.
GWLP_ID -12	Recupera o identificador da janela.
GWL_STYLE -16	Recupera os estilos de janela.
GWLP_USERDATA -21	Recupera os dados do usuário associados à janela. Esses dados são destinados ao uso pelo aplicativo que criou a janela. Seu valor é inicialmente zero.
GWLP_WNDPROC -4	Recupera o ponteiro para o procedimento de janela ou um identificador que representa o ponteiro para o procedimento de janela. Você deve usar a função CallWindowProc para chamar o procedimento de janela.

Os valores a seguir também estão disponíveis quando o parâmetro hWnd identifica uma caixa de diálogo.

Valor	Significado
DWLP_DLGPROC DWLP_MSGRESULT + sizeof(LRESULT)	Recupera o ponteiro para o procedimento da caixa de diálogo ou um identificador que representa o ponteiro para o procedimento da caixa de diálogo. Você deve usar a função CallWindowProc para chamar o procedimento da caixa de diálogo.
DWLP_MSGRESULT 0	Recupera o valor retornado de uma mensagem processada no procedimento da caixa de diálogo.
DWLP_USER DWLP_DLGPROC + sizeof(DLGPROC)	Recupera informações adicionais privadas para o aplicativo, como identificadores ou ponteiros.

Valor retornado

Tipo: LONG_PTR

Se a função for bem-sucedida, o valor retornado será o valor solicitado.

Se a função falhar, o valor retornado será zero. Para obter informações de erro estendidas, chame GetLastError.

Se SetWindowLong ou SetWindowLongPtr não tiver sido chamado anteriormente, GetWindowLongPtr retornará zero para valores na janela extra ou na memória da classe.

Comentários

Reserve memória de janela extra especificando um valor diferente de zero no membro cbWndExtra da estrutura WNDCLASSEX usada com a função RegisterClassEx .

Observação

O cabeçalho winuser.h define GetWindowLongPtr como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.

Requisitos


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
Conjunto de APIs	ext-ms-win-ntuser-windowclass-l1-1-0 (introduzido no Windows 8)