MIMEAssociationDialog function

  • Article

Runs the unregistered MIME content type dialog box.

Syntax

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

Parameters

  • hwndParent
    Handle to the parent window of any posted child windows.

  • dwInFlags
    Bit flag value that specifies if an association is to be registered.

  • pcszFile
    Address of a null-terminated string that contains the name of the target file. This file must conform to the content type described by the pcszMIMEContentType parameter.

  • pcszMIMEContentType
    Address of a null-terminated string that contains the unregistered content type.

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

  • ucAppBufLen
    Unsigned integer containing the size of pszAppBuf, in characters.

Return value

Returns one of the following values:

Return code Description
S_OK

The content type was successfully associated with the extension. The extension is associated as the default for the content type, and pszAppBuf points to the string that contains the path of the specified application.
S_FALSE

Nothing was registered.
E_ABORT

The user canceled the operation.
E_FLAGS

The flag combination passed in dwInFlags is invalid.
E_OUTOFMEMORY

There was insufficient memory available to complete the operation.
E_POINTER

One of the input pointers is invalid.

 

Remarks

If the dwInFlags parameter is set to MIMEASSOCDLG_FL_REGISTER_ASSOC (0x0001), the selected application is registered as the handler for the given MIME type. If this bit is clear, no association is registered.

An application is registered only if this flag is set and the user indicates that a persistent association is to be made.

Registration is impossible if the string at pcszFile does not contain an extension.

This function does not validate the syntax of the input content type string at pcszMIMEContentType. A successful return value does not indicate that the specified MIME content type is valid.

Requirements

Minimum supported client

Windows XP

Minimum supported server

Windows 2000 Server

Header

 Intshcut.h

DLL

 Url.dll

Unicode and ANSI names

MIMEAssociationDialogA (ANSI)