GetIconLocationResultFlags Enumeration

Definition

Namespace: DevCase.Win32.Enums
Assembly: DevCase.net48 (in DevCase.net48.dll) Version: 6.0.0.0 (6.0)
XMLNS for XAML: Not mapped to an xmlns.
[FlagsAttribute]
public enum GetIconLocationResultFlags

Remarks

Members

Null 0 Null flag.
SimulateDoc 1 The calling application should create a document icon using the specified icon.
PerInstance 2 Each object of this class has its own icon.

This flag is used internally by the Shell to handle cases like Setup.exe, where objects with identical names can have different icons.

Typical implementations of IExtractIconA / IExtractIconW do not require this flag.

PerClass 4 All objects of this class have the same icon.

This flag is used internally by the Shell.

Typical implementations of IExtractIconA / IExtractIconW do not require this flag because the flag implies that an icon handler is not required to resolve the icon on a per-object basis.

The recommended method for implementing per-class icons is to register a DefaultIcon for the class.

NotFilename 8 The location is not a file name/index pair.

The values in pszIconFile and piIndex cannot be passed to ExtractIcon or ExtractIconEx.

When the NotFilename flag is omitted, the value returned in iconFile param of GetIconLocation(GetIconLocationFlags, StringBuilder, Int32, Int32, GetIconLocationResultFlags) and GetIconLocation(GetIconLocationFlags, StringBuilder, Int32, Int32, GetIconLocationResultFlags) functions is a fully-qualified path name to either a .ico file or to a file that can contain icons.

Also, the value returned in piIndex is an index into that file that identifies which of its icons to use.

Therefore, when the NotFilename flag is omitted, these values can be passed to ExtractIcon or ExtractIconEx(String, Int32, IntPtr, IntPtr, Int32) functions.

DontCache 16 The physical image bits for this icon are not cached by the calling application.
HasThumbnail 32 Undocumented, but appears to indicate thumbnails are available.
Shield 512 Windows Vista only.

The calling application must stamp the icon with the UAC shield.

ForceNoShield 1,024 Windows Vista only.

The calling application must not stamp the icon with the UAC shield.

Encrypted 2,048 Undocumented, but appears to indicate the folder is encrypted.
Compressed 4,096 Undocumented, but appears to indicate a compressed folder.

See Also