Button_SetElevationRequiredState macro (commctrl.h)

Define o estado de elevação necessário para um botão ou link de comando especificado para exibir um ícone com privilégios elevados. Use essa macro ou envie a mensagem BCM_SETSHIELD explicitamente.

Sintaxe

LRESULT Button_SetElevationRequiredState(
  [in] HWND hwnd,
  [in] BOOL fRequired
);

Parâmetros

[in] hwnd

Tipo: HWND

Um identificador para o controle de botão.

[in] fRequired

Tipo: BOOL

VERDADEIRO desenhar um ícone com privilégios elevados ou false caso contrário.

Valor de retorno

Tipo: LRESULT

Retorna 1 se tiver êxito ou um código de erro de outra forma.

Observações

Um aplicativo deve usar comctl32.dll versão 6 para obter essa funcionalidade.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows Vista [somente aplicativos da área de trabalho]
servidor com suporte mínimo	Windows Server 2008 [somente aplicativos da área de trabalho]
da Plataforma de Destino	Windows
cabeçalho	commctrl.h