MMC_TASK_DISPLAY_SYMBOL structure (mmc.h)

The MMC_TASK_DISPLAY_SYMBOL structure is introduced in MMC 1.1.

The MMC_TASK_DISPLAY_SYMBOL structure is used for the uSymbol member of the MMC_TASK_DISPLAY_OBJECT structure to specify all the data required to display a symbol as an image for a task or background on a taskpad.

Syntax

typedef struct _MMC_TASK_DISPLAY_SYMBOL {
  LPOLESTR szFontFamilyName;
  LPOLESTR szURLtoEOT;
  LPOLESTR szSymbolString;
} MMC_TASK_DISPLAY_SYMBOL;

Members

szFontFamilyName

A pointer to a null-terminated string that contains the font family name of the symbol to display.

For example, the following string specifies that the font is Webdings: "Webdings".

This should never be set to a NULL string or an empty string.

szURLtoEOT

A pointer to a null-terminated string that contains the resource path to the EOT (embedded OpenType) file that contains the font for the symbol to display.

The string should have the following form: "res://filepath/imgpath".

where filepath is the full path to the snap-in's DLL that stores the image file as a resource, and imgpath is the resource path of the image file with the snap-in DLL.

For example, the following string specifies that the snap-in DLL (snapin.dll) has a path of "c:\windows\system32\snapin.dll" and that the resource path is img/myfont.eot: "res://c:\windows\system32\snapin.dll/img/myfont.eot".

szSymbolString

A pointer to a null-terminated string that contains the character or characters to display in the symbol.

Remarks

Allocate the szFontFamilyName, szURLtoEOT, and szSymbolString strings used in the structure with the COM API function CoTaskMemAlloc (or the equivalent) and MMC will release them.

Requirements

Requirement	Value
Minimum supported client	Windows Vista
Minimum supported server	Windows Server 2008
Header	mmc.h

See also

IEnumTASK::Next

IExtendTaskPad::GetBackground

MMC_TASK_DISPLAY_BITMAP

MMC_TASK_DISPLAY_OBJECT

MMC_TASK_DISPLAY_TYPE