This topic has not yet been rated - Rate this topic

ASSOCSTR enumeration

Applies to: desktop apps only

Used by IQueryAssociations::GetString to define the type of string that is to be returned.

Syntax

Copy

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_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.
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: Internet Explorer version 6 or later. 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: Internet Explorer version 6 or later. 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: Internet Explorer version 6 or later. 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: Internet Explorer version 6 or later. 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: Internet Explorer version 6 or later. 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: Windows 7 or later. 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.
ASSOCSTR_DELEGATEEXECUTE: Windows 7 or later. 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.
ASSOCSTR_SUPPORTED_URI_PROTOCOLS: Windows 8.
ASSOCSTR_MAX: The maximum defined ASSOCSTR value, used for validation purposes.

Requirements

Minimum supported client	Windows 2000 Professional, Windows XP, Windows 7
Minimum supported server	Windows 2000 Server
Header	Shlwapi.h

Send comments about this topic to Microsoft

Build date: 3/7/2012

Did you find this helpful? Yes No

Not accurate

Not enough depth

Need more code examples

(1500 characters remaining)

Community Content Add

FAQ

Error in differences with _INFOTIP and _QUICKTIP?

Hmmm. The docs aren't very clear on the differences between _INFOTIP and _QUICKTIP. The QuickTip section states that it "returns properties that are safe for any scenario that causes slow property retrieval, such as offline or slow networks". Does this mean it can return slow items, or it doesn't return slow items? Given the name, I suspect it does *not* return slow items.

"Some of the properties returned from ASSOCSTR_INFOTIP might not be slow property retrieval scenarios"

should this read:

"Some of the properties returned from ASSOCSTR_INFOTIP might not be [appropriate in] slow property retrieval scenarios"

?

Cheers
Matt

History

5/8/2008
Matt Ellis