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 |
|
|
IDL |
|
See also