Método IShellIconOverlayIdentifier::GetPriority (shobjidl_core.h)
Especifica la prioridad de una superposición de icono.
Sintaxis
HRESULT GetPriority(
[out] int *pPriority
);
Parámetros
[out] pPriority
Tipo: int*
Dirección de un valor que indica la prioridad del identificador de superposición. Los valores posibles van de cero a 100, con cero la prioridad más alta.
Valor devuelto
Tipo: HRESULT
Devuelve S_OK si se ejecuta correctamente o un código de error COM de lo contrario.
Comentarios
Si hay más de una superposición de iconos disponible para un objeto, se elige la que tiene prioridad más alta. El Shell tiene un conjunto de reglas internas que determinan la prioridad para muchos casos. El valor devuelto por GetPriority se usa para aquellos casos en los que no se aplican las reglas internas del Shell. Normalmente, debe establecer el valor en cero. Sin embargo, el valor de prioridad es útil cuando se han implementado dos o más controladores de superposición de iconos que pueden solicitar iconos de superposición de iconos para el mismo objeto. Al establecer los valores de prioridad correctamente, puede especificar cuál de las superposiciones de icono solicitadas se mostrará.
Requisitos
| Cliente mínimo compatible | Windows 2000 Professional, Windows XP [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows Server 2003 [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | shobjidl_core.h (incluya Shlobj.h) |
| Archivo DLL | Shell32.dll (versión 5.0 o posterior) |