URLAssociationDialog Function

---

Invokes the unregistered URL protocol dialog box. This dialog box allows the user to select an application to associate with a previously unknown protocol.

Syntax

HRESULT WINAPI URLAssociationDialog(
    HWND hwndParent,
    DWORD dwInFlags,
    LPCSTR pcszFile,
    LPCSTR pcszURL,
    LPSTR pszAppBuf,
    UINT ucAppBufLen
);

Parameters

hwndParent

Handle to the parent window.

dwInFlags

Bit flags that specify the behavior of the function. This value can be one or more of the following:

URLASSOCDLG_FL_USE_DEFAULT_NAME

Use the default file name (that is, "Internet Shortcut").

URLASSOCDLG_FL_REGISTER_ASSOC

Register the selected application as the handler for the protocol specified in pcszURL. The application is registered only if this flag is set and the user indicates that a persistent association is desired.

pcszFile

Address of a constant zero-terminated string that contains the file name to associate with the URL's protocol.

pcszURL

Address of a constant zero-terminated string that contains the URL with an unknown protocol.

pszAppBuf

Address of a buffer that receives the path of the application specified by the user.

ucAppBufLen

Unsigned integer that contains the size of pszAppBuf, in characters.

Return Value

Returns S_OK if the application is registered with the URL protocol, or S_FALSE if nothing is registered. For example, the function returns S_FALSE when the user elects to perform a one-time execution via the selected application.

Function Information

Windows NT	Use version 4.0. Implemented as ANSI and Unicode functions.
Windows	Use Windows 95 and later. Implemented as ANSI and Unicode functions.
Header	Intshcut.h
Minimum availability	Internet Explorer 4.0