Export (0) Print
Expand All

IApplicationAssociationRegistration::SetAppAsDefault method

Sets an application as the default for a given type. For more information, see Default Programs. Not intended for use in Windows 8.

Syntax


HRESULT SetAppAsDefault(
  [in]  LPCWSTR pszAppRegistryName,
  [in]  LPCWSTR pszSet,
  [in]  ASSOCIATIONTYPE atSetType
);

Parameters

pszAppRegistryName [in]

Type: LPCWSTR

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

pszSet [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.

atSetType [in]

Type: ASSOCIATIONTYPE

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

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::SetAppAsDefault in an implementation of a fictitious Contoso browser, setting itself as the default for the .htm file name extension.


HRESULT SetContosoAsDefaultForDotHTM()
{
    IApplicationAssociationRegistration* pAAR;

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

        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:
© 2014 Microsoft