Função GetWindowLongPtrA (winuser.h)

Artigo
11/20/2024

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

Observação Para escrever um 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

Tipo: 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 de retorno

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.

Observações

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

Nota

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 do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows 2000 Professional [somente aplicativos da área de trabalho]
servidor com suporte mínimo	Windows 2000 Server [somente aplicativos da área de trabalho]
da Plataforma de Destino	Windows
cabeçalho	winuser.h (inclua Windows.h)
biblioteca	User32.lib
de DLL	User32.dll
conjunto de API	ext-ms-win-ntuser-windowclass-l1-1-0 (introduzido no Windows 8)

Consulte também

CallWindowProc

Conceitual

de referência de

RegisterClassEx

SetParent

setWindowLongPtr

WNDCLASSEX

classes de janela

Compartilhar via