IPropertyDescriptionList::GetAt-Methode (propsys.h)

  • Artikel

Ruft die Eigenschaftenbeschreibung am angegebenen Index in einer Eigenschaftenbeschreibungsliste ab.

Syntax

HRESULT GetAt(
  [in]  UINT   iElem,
  [in]  REFIID riid,
  [out] void   **ppv
);

Parameter

[in] iElem

Typ: UINT

Die Nummer der Eigenschaft in der Listenzeichenfolge.

[in] riid

Typ: REFIID

Ein Verweis auf die IID der angeforderten Eigenschaftenbeschreibungsschnittstelle, in der Regel IID_IPropertyDescription.

[out] ppv

Typ: void**

Wenn diese Methode zurückgibt, enthält den in riid angeforderten Schnittstellenzeiger. In der Regel ist dies IPropertyDescription.

Rückgabewert

Typ: HRESULT

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

Hinweise

Es wird empfohlen, das makro IID_PPV_ARGS zu verwenden, das in objbase.h definiert ist, um die Parameter riid und ppv zu packen. Dieses Makro stellt die richtige IID basierend auf der Schnittstelle bereit, auf die der Wert in ppv verweist, wodurch die Möglichkeit eines Codierungsfehlers beseitigt wird.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile propsys.h