estructura MMC_TASK_DISPLAY_SYMBOL (mmc.h)

Artículo
08/24/2023

La estructura MMC_TASK_DISPLAY_SYMBOL se introduce en MMC 1.1.

La estructura MMC_TASK_DISPLAY_SYMBOL se usa para el miembro uSymbol de la estructura MMC_TASK_DISPLAY_OBJECT para especificar todos los datos necesarios para mostrar un símbolo como una imagen para una tarea o fondo en un panel de tareas.

Sintaxis

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

Members

szFontFamilyName

Puntero a una cadena terminada en null que contiene el nombre de familia de fuentes del símbolo que se va a mostrar.

Por ejemplo, la cadena siguiente especifica que la fuente es Webdings: "Webdings".

Esto nunca debe establecerse en una cadena NULL o en una cadena vacía.

szURLtoEOT

Puntero a una cadena terminada en null que contiene la ruta de acceso del recurso al archivo EOT (OpenType incrustado) que contiene la fuente para que se muestre el símbolo.

La cadena debe tener el siguiente formato: "res:// filepath/imgpath".

donde filepath es la ruta de acceso completa al archivo DLL del complemento que almacena el archivo de imagen como un recurso y imgpath es la ruta de acceso del recurso del archivo de imagen con el archivo DLL del complemento.

Por ejemplo, la cadena siguiente especifica que el archivo DLL del complemento (snapin.dll) tiene una ruta de acceso de "c:\windows\system32\snapin.dll" y que la ruta de acceso del recurso es img/myfont.eot: "res://c:\windows\system32\snapin.dll/img/myfont.eot".

szSymbolString

Puntero a una cadena terminada en null que contiene el carácter o los caracteres que se van a mostrar en el símbolo.

Comentarios

Asigne las cadenas szFontFamilyName, szURLtoEOT y szSymbolString usadas en la estructura con la función de API COM CoTaskMemAlloc (o el equivalente) y MMC los liberará.