MMC_TASK estructura (mmc.h)

Artículo
03/08/2023

La estructura MMC_TASK se introduce en MMC 1.1.

El método IEnumTASK::Next rellena la estructura MMC_TASK para especificar todos los datos necesarios para configurar una tarea individual en un panel de tareas.

Sintaxis

typedef struct _MMC_TASK {
  MMC_TASK_DISPLAY_OBJECT sDisplayObject;
  LPOLESTR                szText;
  LPOLESTR                szHelpString;
  MMC_ACTION_TYPE         eActionType;
  union {
    LONG_PTR nCommandID;
    LPOLESTR szActionURL;
    LPOLESTR szScript;
  };
} MMC_TASK;

Miembros

sDisplayObject

MMC_TASK_DISPLAY_OBJECT estructura que el complemento debe rellenar para especificar la imagen que se va a mostrar como la imagen de la tarea en el panel de tareas especificado por pszGroup.

szText

Puntero a una cadena terminada en null que contiene el texto situado directamente a la derecha de la imagen de mouse sobre. Este texto sirve como etiqueta para la tarea. Este texto debe ser una acción en el imperativo, como "Agregar un nuevo usuario".

szHelpString

Puntero a una cadena terminada en null que contiene el texto descriptivo situado en la esquina superior derecha cuando el usuario mueve el mouse sobre la imagen o el texto de la etiqueta de la tarea. Este texto sirve como descripción de la tarea, como "Crea una nueva cuenta, crea un buzón y configura todo lo que un usuario debe tener acceso a la red".

eActionType

Valor de tipo MMC_ACTION_TYPE que especifica el tipo de acción desencadenada cuando un usuario hace clic en una tarea en un panel de tareas.

Hay tres tipos de acciones:

MMC_ACTION_ID

Cuando el usuario hace clic en la tarea, MMC llama a IExtendTaskPad::TaskNotify y devuelve el identificador de comando especificado en el miembro nCommandID . Si especifica este valor, se requiere el miembro nCommandID .

MMC_ACTION_LINK

Cuando el usuario hace clic en la tarea, MMC activa el vínculo especificado por szActionURL. Si especifica este valor, se requiere el miembro szActionURL .

MMC_ACTION_SCRIPT

Cuando el usuario hace clic en la tarea, MMC ejecuta el script contenido en szScript mediante el método window.execScript en la página DHTML del panel de tareas. Si especifica este valor, se requiere el miembro zScript .

nCommandID

Solo se usa si eActionType es MMC_ACTION_ID.

Valor que especifica el identificador de comando devuelto al complemento cuando el usuario hace clic en la tarea.

Cuando MMC llama a IExtendTaskPad::TaskNotify, pasa en el parámetro arg una estructura VARIANT que contiene el identificador de comando de la tarea en la que se hizo clic en el panel de tareas. El campo vt es VT_I4 y el campo lVal contiene el identificador de comando.

szActionURL

Solo se usa si eActionType está MMC_ACTION_LINK.

[out] Puntero a una cadena terminada en null que contiene la dirección URL a la que se vincula la tarea. La dirección URL debe ser completa. La cadena también puede contener un script en lugar de una dirección URL.

szScript

Solo se usa si eActionType está MMC_ACTION_SCRIPT.

[out] Puntero a una cadena terminada en null que contiene el script que se va a ejecutar mediante el método window.execScript en la página DHTML del panel de tareas. Para especificar el lenguaje de script, comience la cadena con el lenguaje de script:

"VBSCRIPT:"
"JSCRIPT:"
"JAVASCRIPT:"

Si no se especifica ningún lenguaje de script, el lenguaje predeterminado es JavaScript.

Comentarios

Asigne las cadenas szText, szHelpString, szActionURL y szScript usadas en la estructura con la función de API COM CoTaskMemAlloc (o el equivalente) y MMC las liberará.

También debe asignar las cadenas de la estructura MMC_TASK_DISPLAY_BITMAP o MMC_TASK_DISPLAY_SYMBOL especificada en el miembro sDisplayObject con CoTaskMemAlloc (o el equivalente) y MMC los liberará.