IApplicationAssociationRegistration::QueryAppIsDefault method (shobjidl_core.h)

Determines whether an application owns the registered default association for a given application level and type. Not intended for use in Windows 8.

Syntax

HRESULT QueryAppIsDefault(
  [in]  LPCWSTR          pszQuery,
  [in]  ASSOCIATIONTYPE  atQueryType,
  [in]  ASSOCIATIONLEVEL alQueryLevel,
  [in]  LPCWSTR          pszAppRegistryName,
  [out] BOOL             *pfDefault
);

Parameters

[in] pszQuery

Type: LPCWSTR

A pointer to a null-terminated Unicode string that contains the file name extension or protocol of the application, such as .mp3 or http.

[in] atQueryType

Type: ASSOCIATIONTYPE

One of the ASSOCIATIONTYPE enumeration values that specifies the type of the application named in pszQuery, such as file name extension or MIME type.

[in] alQueryLevel

Type: ASSOCIATIONLEVEL

One of the ASSOCIATIONLEVEL enumeration values that specifies the level of association, such as per-user or machine. This is typically AL_EFFECTIVE.

[in] pszAppRegistryName

Type: LPCWSTR

A pointer to a null-terminated Unicode string that specifies the registered name of the application.

[out] pfDefault

Type: BOOL*

When this method returns, contains TRUE if the application is the default; or FALSE otherwise.

Return value

Type: HRESULT

If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Requirements

Requirement Value
Minimum supported client Windows Vista [desktop apps only]
Minimum supported server Windows Server 2008 [desktop apps only]
Target Platform Windows
Header shobjidl_core.h (include Shobjidl.h)

See also

Default Programs

IApplicationAssociationRegistration