IApplicationAssociationRegistration::QueryCurrentDefault-Methode (shobjidl_core.h)

Artikel
03/02/2024

Bestimmt die Standardanwendung für einen bestimmten Zuordnungstyp. Dies ist die Standardanwendung, die von ShellExecute für diesen Typ gestartet wurde.

Syntax

HRESULT QueryCurrentDefault(
  [in]  LPCWSTR          pszQuery,
  [in]  ASSOCIATIONTYPE  atQueryType,
  [in]  ASSOCIATIONLEVEL alQueryLevel,
  [out] LPWSTR           *ppszAssociation
);

Parameter

[in] pszQuery

Typ: LPCWSTR

Ein Zeiger auf eine Unicode-Zeichenfolge mit Null-Beendigung, die die Dateinamenerweiterung oder das -Protokoll enthält, z. B. .mp3 oder HTTP.

[in] atQueryType

Typ: ASSOCIATIONTYPE

Einer der ASSOCIATIONTYPE-Enumerationswerte , der den Typ der Zuordnung angibt, z. B. Erweiterung oder MIME-Typ.

[in] alQueryLevel

Typ: ASSOCIATIONLEVEL

Einer der ASSOCIATIONLEVEL-Enumerationswerte , der die Zuordnungsebene angibt, z. B. pro Benutzer oder Computer. Dies ist in der Regel AL_EFFECTIVE.

[out] ppszAssociation

Typ: LPWSTR*

Wenn diese Methode zurückgibt, enthält die Adresse eines Zeigers auf die ProgID, die die aktuelle Standardzuordnung identifiziert.

Hinweis Es liegt in der Verantwortung der aufrufenden Anwendung, die Zeichenfolge über CoTaskMemFree freizugeben.

Rückgabewert

Typ: HRESULT

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

Hinweise

Die erzeugte Zeichenfolge ist in der Regel eine ProgID, die einer der progIDs entspricht, die einer registrierten Anwendung zugeordnet sind, aber es gibt einige Ausnahmen: Wenn die zurückgegebene Zeichenfolge ein Standardprotokoll des Computers ist, handelt es sich um eine Legacyzeichenfolge, die eine Befehlszeile an einen .exe-Handler anstelle einer ProgID angibt. Wenn sie einen Standard-MIME-Typ des Computers zurückgibt, wird eine CLSID-Zeichenfolge (Legacy Class Identifier) anstelle einer ProgID 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 (einschließlich Shobjidl.h)

Weitere Informationen

Standardprogramme

IApplicationAssociationRegistration

Freigeben über