Metodo IShellIconOverlayIdentifier::GetPriority (shobjidl_core.h)

Specifica la priorità di una sovrimpressione icona.

Sintassi

HRESULT GetPriority(
  [out] int *pPriority
);

Parametri

[out] pPriority

Tipo: int*

Indirizzo di un valore che indica la priorità dell'identificatore di sovrimpressione. I valori possibili sono compresi tra zero e 100, con zero la priorità più alta.

Valore restituito

Tipo: HRESULT

Restituisce S_OK in caso di esito positivo o un codice di errore COM in caso contrario.

Commenti

Se per un oggetto è disponibile più di una sovrimpressione icona, viene scelto quello con priorità più alta. Shell include un set di regole interne che determinano la priorità per molti casi. Il valore restituito da GetPriority viene usato per i casi in cui le regole interne della shell non si applicano. In genere, è necessario impostare il valore su zero. Tuttavia, il valore di priorità è utile quando sono stati implementati due o più gestori di sovrapposizione di icone che possono richiedere icone di sovrapposizione di icone per lo stesso oggetto. Impostando i valori di priorità in modo appropriato, è possibile specificare quali sovrapposizioni di icone richieste verranno visualizzate.

Requisiti

Vedi anche

IShellIconOverlayIdentifier