IPerPropertyBrowsing::GetDisplayString-Methode (ocidl.h)

  • Artikel

Ruft eine Textzeichenfolge ab, die die angegebene Eigenschaft beschreibt.

Syntax

HRESULT GetDisplayString(
  [in]  DISPID dispID,
  [out] BSTR   *pBstr
);

Parameter

[in] dispID

Der Verteilerbezeichner der Eigenschaft, deren Anzeigename angefordert wird.

[out] pBstr

Ein Zeiger auf eine Variable, die den Anzeigenamen für die in dispID identifizierte Eigenschaft empfängt. Die Zeichenfolge wird von dieser Methode mithilfe von SysAllocString zugeordnet. Nach der Rückgabe liegt die Zeichenfolge in der Verantwortung des Aufrufers, der sie mit SysFreeString freigeben muss, wenn sie nicht mehr benötigt wird.

Rückgabewert

Diese Methode kann die Standardrückgabewerte E_INVALIDARG, E_OUTOFMEMORY und E_UNEXPECTED sowie die folgenden Werte zurückgeben.

Rückgabecode BESCHREIBUNG
S_OK
 Der Anzeigename wurde erfolgreich zurückgegeben.
E_NOTIMPL
 Das -Objekt stellt keine Anzeigenamen für einzelne Eigenschaften bereit. Der Aufrufer kann in diesem Fall die Typinformationen des Objekts auf den Textnamen des Objekts überprüfen.
E_POINTER
 Die Adresse in pbstr ist ungültig. Es kann z. B. NULL sein.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile ocidl.h

Weitere Informationen

IPerPropertyBrowsing