ASSOCSTR enumeration
Used by IQueryAssociations::GetString to define the type of string that is to be returned.
Syntax
typedef enum { ASSOCSTR_COMMAND = 1, ASSOCSTR_EXECUTABLE, ASSOCSTR_FRIENDLYDOCNAME, ASSOCSTR_FRIENDLYAPPNAME, ASSOCSTR_NOOPEN, ASSOCSTR_SHELLNEWVALUE, ASSOCSTR_DDECOMMAND, ASSOCSTR_DDEIFEXEC, ASSOCSTR_DDEAPPLICATION, ASSOCSTR_DDETOPIC, ASSOCSTR_INFOTIP, ASSOCSTR_QUICKTIP, ASSOCSTR_TILEINFO, ASSOCSTR_CONTENTTYPE, ASSOCSTR_DEFAULTICON, ASSOCSTR_SHELLEXTENSION, ASSOCSTR_DROPTARGET, ASSOCSTR_DELEGATEEXECUTE, ASSOCSTR_SUPPORTED_URI_PROTOCOLS, ASSOCSTR_PROGID, ASSOCSTR_APPID, ASSOCSTR_APPPUBLISHER, ASSOCSTR_APPICONREFERENCE, ASSOCSTR_MAX } ASSOCSTR;
Constants
- ASSOCSTR_COMMAND
-
A command string associated with a Shell verb.
- ASSOCSTR_EXECUTABLE
-
An executable from a Shell verb command string. For example, this string is found as the (Default) value for a subkey such as HKEY_CLASSES_ROOT\ApplicationName\shell\Open\command. If the command uses Rundll.exe, set the ASSOCF_REMAPRUNDLL flag in the flags parameter of IQueryAssociations::GetString to retrieve the target executable.
CautionNot all app associations have executables. Do not assume that an executable will always be present.
This type of string will identify the code that will be invoked in the implementation of the verb.
- ASSOCSTR_FRIENDLYDOCNAME
-
The friendly name of a document type.
- ASSOCSTR_FRIENDLYAPPNAME
-
The friendly name of an executable file.
- ASSOCSTR_NOOPEN
-
Ignore the information associated with the open subkey.
- ASSOCSTR_SHELLNEWVALUE
-
Look under the ShellNew subkey.
- ASSOCSTR_DDECOMMAND
-
A template for DDE commands.
- ASSOCSTR_DDEIFEXEC
-
The DDE command to use to create a process.
- ASSOCSTR_DDEAPPLICATION
-
The application name in a DDE broadcast.
- ASSOCSTR_DDETOPIC
-
The topic name in a DDE broadcast.
- ASSOCSTR_INFOTIP
-
Corresponds to the InfoTip registry value. Returns an info tip for an item, or list of properties in the form of an IPropertyDescriptionList from which to create an info tip, such as when hovering the cursor over a file name. The list of properties can be parsed with PSGetPropertyDescriptionListFromString.
- ASSOCSTR_QUICKTIP
-
Introduced in Internet Explorer 6. Corresponds to the QuickTip registry value. Same as ASSOCSTR_INFOTIP, except that it always returns a list of property names in the form of an IPropertyDescriptionList. The difference between this value and ASSOCSTR_INFOTIP is that this returns properties that are safe for any scenario that causes slow property retrieval, such as offline or slow networks. Some of the properties returned from ASSOCSTR_INFOTIP might not be appropriate for slow property retrieval scenarios. The list of properties can be parsed with PSGetPropertyDescriptionListFromString.
- ASSOCSTR_TILEINFO
-
Introduced in Internet Explorer 6. Corresponds to the TileInfo registry value. Contains a list of properties to be displayed for a particular file type in a Windows Explorer window that is in tile view. This is the same as ASSOCSTR_INFOTIP, but, like ASSOCSTR_QUICKTIP, it also returns a list of property names in the form of an IPropertyDescriptionList. The list of properties can be parsed with PSGetPropertyDescriptionListFromString.
- ASSOCSTR_CONTENTTYPE
-
Introduced in Internet Explorer 6. Describes a general type of MIME file association, such as image and bmp, so that applications can make general assumptions about a specific file type.
- ASSOCSTR_DEFAULTICON
-
Introduced in Internet Explorer 6. Returns the path to the icon resources to use by default for this association. Positive numbers indicate an index into the dll's resource table, while negative numbers indicate a resource ID. An example of the syntax for the resource is "c:\myfolder\myfile.dll,-1".
- ASSOCSTR_SHELLEXTENSION
-
Introduced in Internet Explorer 6. For an object that has a Shell extension associated with it, you can use this to retrieve the CLSID of that Shell extension object by passing a string representation of the IID of the interface you want to retrieve as the pwszExtra parameter of IQueryAssociations::GetString. For example, if you want to retrieve a handler that implements the IExtractImage interface, you would specify "{BB2E617C-0920-11d1-9A0B-00C04FC2D6C1}", which is the IID of IExtractImage.
- ASSOCSTR_DROPTARGET
-
Introduced in Internet Explorer 8.. For a verb invoked through COM and the IDropTarget interface, you can use this flag to retrieve the IDropTarget object's CLSID. This CLSID is registered in the DropTarget subkey. The verb is specified in the pwszExtra parameter in the call to IQueryAssociations::GetString.
This type of string will identify the code that will be invoked in the implementation of the verb.
- ASSOCSTR_DELEGATEEXECUTE
-
Introduced in Internet Explorer 8.. For a verb invoked through COM and the IExecuteCommand interface, you can use this flag to retrieve the IExecuteCommand object's CLSID. This CLSID is registered in the verb's command subkey as the DelegateExecute entry. The verb is specified in the pwszExtra parameter in the call to IQueryAssociations::GetString.
This type of string will identify the code that will be invoked in the implementation of the verb.
- ASSOCSTR_SUPPORTED_URI_PROTOCOLS
-
Introduced in Windows 8.
- ASSOCSTR_PROGID
-
The ProgID provided by the app associated with the file type or URI scheme. This if configured by users in their default program settings.
- ASSOCSTR_APPID
-
The AppUserModelID of the app associated with the file type or URI scheme. This is configured by users in their default program settings.
- ASSOCSTR_APPPUBLISHER
-
The publisher of the app associated with the file type or URI scheme. This is configured by users in their default program settings.
- ASSOCSTR_APPICONREFERENCE
-
The icon reference of the app associated with the file type or URI scheme. This is configured by users in their default program settings.
- ASSOCSTR_MAX
-
The maximum defined ASSOCSTR value, used for validation purposes.
Requirements
|
Minimum supported client |
Windows 2000 Professional, Windows XP, Windows 7 [desktop apps only] |
|---|---|
|
Minimum supported server |
Windows 2000 Server [desktop apps only] |
|
Header |
|