IItemPropertyBag::Read-Methode

Artikel
06/13/2023

Bewirkt, dass eine oder mehrere Eigenschaften aus dem Eigenschaftenbehälter gelesen werden. Die IItemPropertyBag-Schnittstelle wird nur unter 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 lesenden 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, das die Eigenschaftswerte empfängt.
phrError [out]: Zeiger auf ein Array von HRESULT-Werten , das das Ergebnis jeder gelesenen Eigenschaft empfängt. In diesem Array müssen mindestens cProperties-Elemente vorhanden sein.

Rückgabewert

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

Bemerkungen

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

Um Anlagen mit einem Protokollhandler eines Drittanbieters auf Computern mit Windows XP oder Windows Server 2003 in der Vorschau anzuzeigen, müssen möglicherweise die IItemPropertyBag-Schnittstelle und die folgenden APIs verwendet werden: die ISearchProtocolUI-, IItemPreviewerExt- und ISearchItem-Schnittstellen , die Strukturen LINKINFO und ITEMPROP sowie die LINKTYPE-Enumeration .

Anforderungen

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

Siehe auch

IItemPropertyBag

Freigeben über