Metodo IAssocHandler::IsRecommended (shobjidl_core.h)

Indica se l'applicazione è registrata come gestore consigliato per il tipo di file sottoposto a query.

Sintassi

HRESULT IsRecommended();

Valore restituito

Tipo: HRESULT

Restituisce S_OK se il programma è consigliato; in caso contrario, S_FALSE.

Commenti

Le applicazioni che si registrano come gestori per determinati tipi di file possono specificare se sono gestori consigliati. Questo non ha alcun effetto sul comportamento effettivo delle applicazioni al momento dell'avvio. Viene semplicemente fornito come hint per l'utente e un valore che l'interfaccia utente può usare a livello di codice, se lo si desidera. Ad esempio, la finestra di dialogo Apri con della shell separa le voci in Programmi consigliati e altri programmi.

Si noti che le raccomandazioni del programma possono cambiare nel tempo. Un esempio viene fornito quando l'utente sceglie un'applicazione dalla finestra di dialogo Altri programmi della finestra di dialogo Apri con per aprire un tipo di file specifico. Ciò può causare la "promozione" della shell dello stato consigliato dell'applicazione per quel tipo di file. Poiché lo stato consigliato può cambiare nel tempo, le applicazioni non devono memorizzare nella cache questo valore, ma eseguirne una query ogni volta che è necessario.

Se SHAssocEnumHandlers è stato chiamato con il flag ASSOC_FILTER_RECOMMENDED, vengono restituiti solo i gestori consigliati. Se è stato usato il flag ASSOC_FILTER_NONE, è necessario chiamare IAssocHandler::IsRecommended in ogni oggetto IAssocHandler per determinare se è consigliato o meno.

Requisiti

Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	shobjidl_core.h (include Shobjidl.h)