Windows Dev Center

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

 

 

Community Additions

ADD
Show:
© 2015 Microsoft