Método IShellIconOverlayIdentifier::GetPriority (shobjidl_core.h)

  • Artigo

Especifica a prioridade de uma sobreposição de ícone.

Sintaxe

HRESULT GetPriority(
  [out] int *pPriority
);

Parâmetros

[out] pPriority

Tipo: int*

O endereço de um valor que indica a prioridade do identificador de sobreposição. Os valores possíveis variam de zero a 100, sem a prioridade mais alta.

Valor retornado

Tipo: HRESULT

Retorna S_OK se tiver êxito ou um código de erro COM caso contrário.

Comentários

Se mais de uma sobreposição de ícone estiver disponível para um objeto , a com prioridade mais alta será escolhida. O Shell tem um conjunto de regras internas que determinam a prioridade para muitos casos. O valor retornado por GetPriority é usado para os casos em que as regras internas do Shell não se aplicam. Normalmente, você deve definir o valor como zero. No entanto, o valor de prioridade é útil quando você implementa dois ou mais manipuladores de sobreposição de ícones que podem solicitar ícones de sobreposição de ícones para o mesmo objeto. Definindo os valores de prioridade adequadamente, você pode especificar quais das sobreposições de ícone solicitadas serão exibidas.

Requisitos

   
Cliente mínimo com suporte Windows 2000 Professional, Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho shobjidl_core.h (inclua Shlobj.h)
DLL Shell32.dll (versão 5.0 ou posterior)

Confira também

IShellIconOverlayIdentifier