Internet Shortcut Enumerated Types

Internet Shortcut Enumerated Types Overview

This section contains information on the following Internet Shortcut enumerated types.

IURL_SETURL_FLAGS

typedef enum iurl_seturl_flags{
   IURL_SETURL_FL_GUESS_PROTOCOL         = 0x0001,
   IURL_SETURL_FL_USE_DEFAULT_PROTOCOL   = 0x0002
} IURL_SETURL_FLAGS;

The following enumerated values are used with the IUniformResourceLocator::SetURL method. They are passed-in as the dwInFlags parameter.

IURL_SETURL_FL_GUESS_PROTOCOL: If the protocol scheme is not specified in the pcszURL parameter to IUniformResourceLocator::SetURL, the system will automatically choose a scheme and add it to the URL.
IURL_SETURL_FL_USE_DEFAULT_PROTOCOL: If the protocol scheme is not specified in the pcszURL parameter to IUniformResourceLocator::SetURL, the system will add the default protocol to the URL.

IURL_SETURL_INVOKECOMMAND_FLAGS

typedef enum iurl_invokecommand_flags{
   IURL_INVOKECOMMAND_FL_ALLOW_UI           = 0x0001,
   IURL_INVOKECOMMAND_FL_USE_DEFAULT_VERB   = 0x0002,
} IURL_INVOKECOMMAND_FLAGS;

The following enumerated values are used in the dwFlags member of the URLINVOKECOMMANDINFO structure.

IURL_INVOKECOMMAND_FL_ALLOW_UI: If this bit is set, interaction with the user is allowed and the hwndParent member of the URLINVOKECOMMANDINFO structure is valid. If this bit is clear, interaction with the user is not allowed and the hwndParent member is ignored.
IURL_INVOKECOMMAND_FL_USE_DEFAULT_VERB: If this bit is set, the default verb for the Internet Shortcut's protocol is to be used and the pcszVerb member of the URLINVOKECOMMANDINFO structure is ignored. If this bit is clear, the verb is specified by pcszVerb.

MIMEASSOCIATIONDIALOG_IN_FLAGS

typedef enum mimeassociationdialog_in_flags{
    MIMEASSOCDLG_FL_REGISTER_ASSOC     = 0x0001
} MIMEASSOCIATIONDIALOG_IN_FLAGS;

The following enumerated values are used with the MIMEAssociationDialog function to determine how it executes.

MIMEASSOCDLG_FL_REGISTER_ASSOC: Register the selected application will as the handler for the given MIME type. If this bit is clear, no association will be registered.

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

TRANSLATEURL_IN_FLAGS

typedef enum translateurl_in_flags {
    TRANSLATEURL_FL_GUESS_PROTOCOL         = 0x0001,
    TRANSLATEURL_FL_USE_DEFAULT_PROTOCOL   = 0x0002,
} TRANSLATEURL_IN_FLAGS;

The following enumerated values are used with the TranslateURL function to determine how it will execute.

TRANSLATEURL_FL_GUESS_PROTOCOL: If the protocol scheme is not specified in the pcszURL parameter to TranslateURL, the system will automatically choose a scheme and add it to the URL.
TRANSLATEURL_FL_USE_DEFAULT_PROTOCOL: If the protocol scheme is not specified in the pcszURL parameter to TranslateURL, the system will add the default protocol to the URL.

URLASSOCIATIONDIALOG_IN_FLAGS

typedef enum urlassociationdialog_in_flags {
    URLASSOCDLG_FL_USE_DEFAULT_NAME  = 0x0001,
    URLASSOCDLG_FL_REGISTER_ASSOC    = 0x0002
} URLASSOCIATIONDIALOG_IN_FLAGS;

The following enumerated values are used with the URLAssociationDialog function to determine how it will execute.

URLASSOCDLG_FL_USE_DEFAULT_NAME: Use the default file name (i.e. "Internet Shortcut").
URLASSOCDLG_FL_REGISTER_ASSOC: Register the selected application as the handler for the protocol specified in the pcszURL parameter of URLAssociationDialog. The application is only registered if this flag is set and the user indicates that a persistent association is desired.