IExtendTaskPad::GetBackground-Methode (mmc.h)

Mit der IExtendTaskPad::GetBackground-Methode kann MMC das Hintergrundbild des Taskpads abrufen, das in Taskpads angezeigt wird, die MMC-Taskpadvorlagen verwenden.

Syntax

HRESULT GetBackground(
  [in]  LPOLESTR                pszGroup,
  [out] MMC_TASK_DISPLAY_OBJECT *pTDO
);

Parameter

[in] pszGroup

Ein Zeiger auf eine NULL-endende Zeichenfolge, die den Gruppennamen enthält, der das Taskpad identifiziert. Der Gruppenname ist die Zeichenfolge, die auf den Hash (#) in der Zeichenfolge folgt, die im ppViewType-Parameter übergeben wird, wenn MMC IComponent::GetResultViewType aufruft, um das Taskpad anzuzeigen. Wenn kein Gruppenname angegeben wird, ist pszGroup eine NULL-Zeichenfolge .

[out] pTDO

Ein Zeiger auf eine MMC_TASK_DISPLAY_OBJECT Struktur, die das Snap-In ausfüllen muss, um das Bild anzugeben, das als Hintergrund für das von pszGroup angegebene Taskpad angezeigt werden soll.

Beachten Sie, dass der Aufrufer (MMC) den Arbeitsspeicher für die MMC_TASK_DISPLAY_OBJECT-Struktur zuordnet.

Rückgabewert

Diese Methode kann einen dieser Werte zurückgeben.

Hinweise

Ordnen Sie die Zeichenfolgen in der im pTDO-Parameter angegebenen MMC_TASK_DISPLAY_BITMAP - oder MMC_TASK_DISPLAY_SYMBOL-Struktur mit der COM-API-Funktion CoTaskMemAlloc (oder der entsprechenden) zu, und MMC gibt sie frei.

Anforderungen

Weitere Informationen

IExtendTaskPad

MMC_TASK_DISPLAY_BITMAP

MMC_TASK_DISPLAY_OBJECT

MMC_TASK_DISPLAY_SYMBOL