IItemPropertyBag::Read-Methode

Bewirkt, dass eine oder mehrere Eigenschaften aus dem Eigenschaftenbehälter gelesen werden. Die IItemPropertyBag-Schnittstelle wird nur auf Windows XP und Windows Server 2003 unterstützt und sollte nicht mehr verwendet werden.

Syntax

HRESULT Read(
  [in]  ULONG    cProperties,
  [in]  ITEMPROP *pPropBag,
  [out] VARIANT  *pvarValue,
  [out] HRESULT  *phrError
);

Parameter

cProperties [ In]

Die Anzahl der zu lesende Eigenschaften. Dieses Argument gibt die Anzahl der Elemente in den Arrays bei pPropBag, pvarValue und phrError an.

pPropBag [ In]

Zeiger auf ein Array von ITEMPROP-Strukturen, das die angeforderten Eigenschaften angibt.

pvarValue [ out]

Empfängt einen Zeiger, der ein Array von VARIANT-Strukturen zurückgibt, die die Eigenschaftswerte empfangen.

phrError [ out]

Zeiger auf ein Array von HRESULT-Werten, das das Ergebnis der einzelnen gelesenen Eigenschaften empfängt. Dieses Array muss mindestens cProperties-Elemente enthalten.

Rückgabewert

Wenn die Methode erfolgreich ist, wird S _ OK zurückgegeben. Andernfalls wird ein HRESULT-Fehlercode zurückgegeben.

Hinweise

Die IItemPropertyBag-Schnittstelle wird nur auf Windows XP und Windows Server 2003 unterstützt und sollte nicht mehr verwendet werden.

Zum Anzeigen einer Vorschau von Anlagen mit einem Protokollhandler eines Drittanbieters auf Computern, auf denen Windows XP oder Windows Server 2003 ausgeführt wird, ist es möglicherweise erforderlich, die IItemPropertyBag-Schnittstelle und die folgenden APIs zu verwenden: die ISearchProtocolUI-, IItemPreviewerExt- und ISearchItem-Schnittstellen, die LINKINFO- und ITEMPROP-Strukturen und die LINKTYPE-Enumeration.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client)
Windows Nur XP mit [ SP2-Desktop-Apps]
Unterstützte Mindestversion (Server)
Windows Nur Server [ 2003-Desktop-Apps]
Verteilbare Komponente
Windows Desktopsuche (WDS) 3.0

Weitere Informationen

IItemPropertyBag