Função GetClassLongPtrA (winuser.h)

Artigo
11/20/2024

Recupera o valor especificado da estrutura de WNDCLASSEX associada à janela especificada.

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

Sintaxe

ULONG_PTR GetClassLongPtrA(
  [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 valor a ser recuperado. Para recuperar um valor da memória de classe extra, especifique o deslocamento de bytes positivo baseado em zero do valor a ser recuperado. Os valores válidos estão no intervalo zero até o número de bytes de memória de classe extra, menos oito; por exemplo, se você especificou 24 ou mais bytes de memória de classe extra, um valor de 16 seria um índice para o terceiro inteiro. Para recuperar qualquer outro valor da estrutura de WNDCLASSEX , especifique um dos valores a seguir.

Valor	Significado
GCW_ATOM -32	Recupera um valor ATOM que identifica exclusivamente a classe de janela. Esse é o mesmo átomo que a função RegisterClassEx retorna.
GCL_CBCLSEXTRA -20	Recupera o tamanho, em bytes, da memória extra associada à classe.
GCL_CBWNDEXTRA -18	Recupera o tamanho, em bytes, da memória de janela extra associada a cada janela da classe. Para obter informações sobre como acessar essa memória, consulte GetWindowLongPtr.
GCLP_HBRBACKGROUND -10	Recupera um identificador para o pincel de plano de fundo associado à classe.
GCLP_HCURSOR -12	Recupera um identificador para o cursor associado à classe.
GCLP_HICON -14	Recupera um identificador para o ícone associado à classe.
GCLP_HICONSM -34	Recupera um identificador para o ícone pequeno associado à classe.
GCLP_HMODULE -16	Recupera um identificador para o módulo que registrou a classe.
GCLP_MENUNAME -8	Recupera o ponteiro para a cadeia de caracteres de nome do menu. A cadeia de caracteres identifica o recurso de menu associado à classe.
GCL_STYLE -26	Recupera os bits de estilo da classe de janela.
GCLP_WNDPROC -24	Recupera o endereço do procedimento de janela ou um identificador que representa o endereço do procedimento de janela. Você deve usar a função CallWindowProc para chamar o procedimento de janela.

Valor de retorno

Tipo: ULONG_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.

Observações

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

Nota

O cabeçalho winuser.h define GetClassLongPtr 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-2 (introduzido no Windows 10, versão 10.0.10240)

Consulte também

Conceitual

getWindowLongPtr

de referência de

RegisterClassEx

SetClassLongPtr

WNDCLASSEX

classes de janela

Compartilhar via