IShellUIHelper2::IsSearchProviderInstalled Method

  • Article

Determines if a search provider has been installed for the current user and whether it is set as default.

Syntax

HRESULT IsSearchProviderInstalled(
    BSTR URL,
    DWORD *pdwResult
);

Parameters

  • URL
    [in] String that specifies a prefix to the URL for the search provider.
  • pdwResult
    [out, retval] Pointer to an unsigned long integer value that contains return value.
    • 0
      The specified search provider is not installed for the current user.
    • 1
      The specified search provider is installed for the current user.
    • 2
      The specified search provider is installed and is set as the default search provider.

Return Value

Returns S_OK if successful, or an error value otherwise.

Remarks

IShellUIHelper2::IsSearchProviderInstalled was introduced in Windows Internet Explorer 7.

This method indicates whether a specific search provider is installed and is the default search provider for the current user. To determine if a search provider is installed, IsSearchProviderInstalled compares the value of the URL parameter to the list of installed search providers. If any search provider starts with the parameter value, the method indicates a match.

Sites are only allowed to search for providers on the same domain. For example, images.example.com may search for https://search.example.com; however, it cannot search for providers on microsoft.com or other domain names. Searching for providers on different domains generates access denied errors.

See Also

IShellUIHelper2::AddSearchProvider, Search Provider Extensibility in Internet Explorer