SHAssocEnumHandlers-Funktion (shobjidl_core.h)

Artikel
03/02/2024

Gibt ein Enumerationsobjekt für einen angegebenen Satz von Dateinamenerweiterungshandlern zurück.

Syntax

SHSTDAPI SHAssocEnumHandlers(
  [in]  PCWSTR             pszExtra,
  [in]  ASSOC_FILTER       afFilter,
  [out] IEnumAssocHandlers **ppEnumHandler
);

Parameter

[in] pszExtra

Typ: PCWSTR

Ein Zeiger auf einen Puffer mit NULL-Beendigung, der eine einzelne Dateityperweiterung für instance ".jpg" enthält. Nur Handler, die der angegebenen Erweiterung zugeordnet sind, werden aufgezählt. Dieser Parameter ist möglicherweise nicht NULL.

[in] afFilter

Typ: ASSOC_FILTER

Gibt den Enumerationshandlerfilter an, der auf die vollständige Liste von Handlern angewendet wird, die sich aus dem in pszExtra angegebenen Wert ergibt. Einer der folgenden Werte.

Wert	BESCHREIBUNG
ASSOC_FILTER_NONE	Gibt alle Handler zurück.
ASSOC_FILTER_RECOMMENDED	Gibt nur empfohlene Handler zurück. Ein Handler legt den empfohlenen status in der Registrierung fest, wenn er installiert wird. Eine anfängliche status von nicht empfohlenen kann später als Ergebnis einer Benutzeraktion zu empfohlen heraufgestuft werden.

[out] ppEnumHandler

Typ: IEnumAssocHandlers**

Wenn diese Methode zurückgibt, enthält die Adresse eines Zeigers auf ein IEnumAssocHandlers-Objekt .

Rückgabewert

Typ: HRESULT

Wenn diese Funktion erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Anforderungen

Anforderung	Wert
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 (shobjidl.h einschließen)
Bibliothek	Shell32.lib
DLL	Shell32.dll

Share via