Função GetClassWord (winuser.h)

Artigo
03/04/2024

Recupera o valor de 16 bits (WORD) no deslocamento especificado para a memória de classe extra para a classe de janela à qual a janela especificada pertence.

Nota Essa função foi preterida para qualquer uso diferente de nIndex definido como GCW_ATOM. A função é fornecida apenas para compatibilidade com versões de 16 bits do Windows. Os aplicativos devem usar a função GetClassLong ou GetClassLongPtr .

Sintaxe

WORD GetClassWord(
  [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 de bytes 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, menos dois; por exemplo, se você especificasse 10 ou mais bytes de memória de classe extra, um valor de oito seria um índice para o quinto inteiro de 16 bits. Há um valor válido adicional, conforme mostrado na tabela 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 RegisterClass ou RegisterClassEx retorna.

Retornar valor

Tipo: WORD

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

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

Comentários

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

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
Conjunto de APIs	ext-ms-win-ntuser-windowclass-l1-1-2 (introduzido no Windows 10, versão 10.0.10240)