Windows apps
Collapse the table of content
Expand the table of content
Information
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

IApplicationAssociationRegistration::QueryAppIsDefault method

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

pszQuery [in]

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.

atQueryType [in]

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.

alQueryLevel [in]

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.

pszAppRegistryName [in]

Type: LPCWSTR

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

pfDefault [out]

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.

Examples

This example demonstrates the use of IApplicationAssociationRegistration::QueryAppIsDefault in an implementation of a fictitious Contoso browser, querying whether it owns the default for the .htm file name extension.


HRESULT CheckContosoHasDotHTM(__out BOOL* pfHasDotHTM)
{
    IApplicationAssociationRegistration* pAAR;

    HRESULT hr = CoCreateInstance(CLSID_ApplicationAssociationRegistration,
                                  NULL,
                                  CLSCTX_INPROC,
                                  __uuidof(IApplicationAssociationRegistration),
                                  (void**)&pAAR);
    if (SUCCEEDED(hr))
    {
        hr = pAAR->QueryAppIsDefault(L".htm",
                                     AT_FILEEXTENSION,
                                     AL_EFFECTIVE,
                                     L"Contoso.WebBrowser.1.06",
                                     pfHasDotHTM);

        pAAR->Release();
    }

    return hr;
}

Requirements

Minimum supported client

Windows Vista [desktop apps only]

Minimum supported server

Windows Server 2008 [desktop apps only]

Header

Shobjidl.h

IDL

Shobjidl.idl

See also

IApplicationAssociationRegistration
Default Programs

 

 

Show:
© 2017 Microsoft