Contents Index Topic Contents | ||
Previous Topic: InetIsOffline Next Topic: TranslateURL |
MIMEAssociationDialog
HRESULT WINAPI MIMEAssociationDialog ( HWND hwndParent, DWORD dwInFlags, LPCSTR pcszFile, LPCSTR pcszMIMEContentType, LPSTR pszAppBuf, UINT ucAppBufLen );Runs the unregistered MIME content type dialog box.
- Returns S_OK if the content type was successfully associated with the extension. In this case, 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. The function returns S_FALSE if nothing was registered. Otherwise, the return value will be one of the following:
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.
- hwndParent
- Handle to the parent window of any posted child windows.
- dwInFlags
- Bit flag value that specifies if an association is to be registered. The bit flag is the value MIMEASSOCDLG_FL_REGISTER_ASSOC (0x0001). If this bit is set, 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.
- 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
- Size of pszAppBuf, in characters.
Note 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.
Top of Page
© 1997 Microsoft Corporation. All rights reserved. Terms of Use.