MMC_TASK Struktur (mmc.h)

Artikel
03/04/2024

Die MMC_TASK-Struktur wird in MMC 1.1 eingeführt.

Die MMC_TASK-Struktur wird von der IEnumTASK::Next-Methode ausgefüllt, um alle Daten anzugeben, die zum Einrichten einer einzelnen Aufgabe auf einem Taskpad erforderlich sind.

Syntax

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;

Member

sDisplayObject

MMC_TASK_DISPLAY_OBJECT Struktur, die das Snap-In ausfüllen muss, um das Bild anzugeben, das als Bild für die Aufgabe in dem von pszGroup angegebenen Taskpad angezeigt werden soll.

szText

Ein Zeiger auf eine NULL-Zeichenfolge, die den Text enthält, der direkt rechts neben dem Mauszeigerbild platziert wird. Dieser Text dient als Bezeichnung für die Aufgabe. Dieser Text sollte eine Aktion im Imperativ sein, z. B. "Neuen Benutzer hinzufügen".

szHelpString

Ein Zeiger auf eine NULL-Zeichenfolge, die den beschreibenden Text enthält, der in der oberen rechten Ecke platziert wird, wenn der Benutzer die Maus über das Mauszeigerbild oder den Beschriftungstext für die Aufgabe bewegt. Dieser Text dient als Beschreibung für die Aufgabe, z. B. "Erstellt ein neues Konto, erstellt ein Postfach und richtet alles ein, was ein Benutzer auf das Netzwerk zugreifen muss".

eActionType

Wert vom Typ MMC_ACTION_TYPE , der den Typ der Aktion angibt, die ausgelöst wird, wenn ein Benutzer auf eine Aufgabe auf einem Taskpad klickt.

Es gibt drei Arten von Aktionen:

MMC_ACTION_ID

Wenn der Benutzer auf die Aufgabe klickt, ruft MMC IExtendTaskPad::TaskNotify auf und gibt die Befehls-ID zurück, die im nCommandID-Member angegeben ist. Wenn Sie diesen Wert angeben, ist das Element nCommandID erforderlich.

MMC_ACTION_LINK

Wenn der Benutzer auf die Aufgabe klickt, aktiviert MMC den von szActionURL angegebenen Link. Wenn Sie diesen Wert angeben, ist das szActionURL-Element erforderlich.

MMC_ACTION_SCRIPT

Wenn der Benutzer auf die Aufgabe klickt, führt MMC das in szScript enthaltene Skript mithilfe der window.execScript-Methode auf der DHTML-Seite des Taskpads aus. Wenn Sie diesen Wert angeben, ist das zScript-Element erforderlich.

nCommandID

Wird nur verwendet, wenn eActionTypeMMC_ACTION_ID ist.

Ein Wert, der die Befehls-ID angibt, die an das Snap-In zurückgegeben wird, wenn der Benutzer auf die Aufgabe klickt.

Wenn MMC IExtendTaskPad::TaskNotify aufruft, übergibt es im Arg-Parameter eine VARIANT-Struktur , die die Befehls-ID für den Task enthält, auf den das Taskpad geklickt wurde. Das Feld vt ist VT_I4 und das Feld lVal enthält die Befehls-ID.

szActionURL

Wird nur verwendet, wenn eActionTypeMMC_ACTION_LINK ist.

[out] Ein Zeiger auf eine NULL-Zeichenfolge, die die URL enthält, mit der die Aufgabe verknüpft ist. Die URL muss voll qualifiziert sein. Die Zeichenfolge kann auch ein Skript anstelle einer URL enthalten.

szScript

Wird nur verwendet, wenn eActionTypeMMC_ACTION_SCRIPT ist.

[out] Ein Zeiger auf eine null-beendete Zeichenfolge, die das Skript enthält, das mit der window.execScript-Methode auf der Taskpad-DHTML-Seite ausgeführt werden soll. Um die Skriptsprache anzugeben, beginnen Sie die Zeichenfolge mit der Skriptsprache:

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

Wenn keine Skriptsprache angegeben ist, ist JavaScript die Standardsprache.

Hinweise

Ordnen Sie die in der Struktur verwendeten Zeichenfolgen szText, szHelpString, szActionURL und szScript mit der COM-API-Funktion CoTaskMemAlloc (oder der entsprechenden) zu, und MMC gibt sie frei.

Sie sollten die Zeichenfolgen auch in der MMC_TASK_DISPLAY_BITMAP - oder MMC_TASK_DISPLAY_SYMBOL Struktur zuordnen, die im sDisplayObject-Member mit CoTaskMemAlloc (oder dem entsprechenden Element) angegeben ist, und MMC gibt sie frei.