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 |