IAssocHandler::IsRecommended-Methode (shobjidl_core.h)

Gibt an, ob die Anwendung als empfohlener Handler für den abgefragten Dateityp registriert ist.

Syntax

HRESULT IsRecommended();

Rückgabewert

Typ: HRESULT

Gibt S_OK zurück, wenn das Programm empfohlen wird; andernfalls S_FALSE.

Hinweise

Anwendungen, die sich selbst als Handler für bestimmte Dateitypen registrieren, können angeben, ob es sich um empfohlene Handler handelt. Dies hat keine Auswirkungen auf das tatsächliche Verhalten der Anwendungen beim Starten. Es wird einfach als Hinweis für den Benutzer und einen Wert bereitgestellt, den die Benutzeroberfläche programmgesteuert nutzen kann, wenn gewünscht. Das Dialogfeld "Öffnen mit " der Shell unterteilt beispielsweise Einträge in Empfohlene Programme und Andere Programme.

Beachten Sie, dass sich Programmempfehlungen im Laufe der Zeit ändern können. Ein Beispiel ist angegeben, wenn der Benutzer im Dialogfeld Öffnen mit eine Anwendung aus den Anderen Programmen auswäht, um einen bestimmten Dateityp zu öffnen. Dies kann dazu führen, dass die Shell diese Anwendung auf empfohlene status für diesen Dateityp "heraufstufen". Da sich die empfohlene status im Laufe der Zeit ändern kann, sollten Anwendungen diesen Wert nicht zwischenspeichern, sondern ihn jedes Mal abfragen, wenn er benötigt wird.

Wenn SHAssocEnumHandlers mit dem flag ASSOC_FILTER_RECOMMENDED aufgerufen wurde, werden nur empfohlene Handler zurückgegeben. Wenn das ASSOC_FILTER_NONE-Flag verwendet wurde, müssen Sie IAssocHandler::IsRecommended für jedes IAssocHandler-Objekt aufrufen, um zu bestimmen, ob es empfohlen wird oder nicht.

Anforderungen

Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	shobjidl_core.h (einschließlich Shobjidl.h)