Freigeben über


IProgressItems::P rogressItemFromDescription-Methode (imapi2fs.h)

Ruft ein Statuselement basierend auf dem angegebenen Dateinamen ab.

Syntax

HRESULT ProgressItemFromDescription(
  [in]  BSTR          description,
  [out] IProgressItem **item
);

Parameter

[in] description

Zeichenfolge, die den Dateinamen des abzurufenden Statuselements enthält. Die -Methode gibt das Statuselement zurück, wenn diese Zeichenfolge mit dem Wert für die Beschreibungseigenschaft des Elements übereinstimmt.

[out] item

Eine IProgressItem-Schnittstelle des Statuselements, das dem angegebenen Dateinamen zugeordnet ist.

Rückgabewert

S_OK wird bei Erfolg zurückgegeben, aber andere Erfolgscodes können als Ergebnis der Implementierung zurückgegeben werden. Die folgenden Fehlercodes werden häufig bei Vorgangsfehlern zurückgegeben, stellen aber nicht die einzigen möglichen Fehlerwerte dar:

Rückgabecode Beschreibung
E_FAIL
description ist NULL.

Wert:0x80004005

E_POINTER
Der Zeiger ist ungültig.

Wert: 0x80004003

E_OUTOFMEMORY
Fehler beim Zuweisen des erforderlichen Arbeitsspeichers.

Wert: 0x8007000E

E_INVALIDARG
Mindestens ein Argument ist ungültig.

Wert: 0x80070057

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows Vista, Windows XP mit SP2 [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile imapi2fs.h

Weitere Informationen

IProgressItem

IProgressItems

IProgressItems::P rogressItemFromBlock

IProgressItems::get_Item