Freigeben über

SHAssocEnumHandlers-Funktion (shobjidl_core.h)

  • Artikel

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