IPerPropertyBrowsing：：GetDisplayString 方法 (ocidl.h)

擷取描述指定屬性的文字字串。

語法

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

[in] dispID

要求顯示名稱的屬性分派標識碼。

[out] pBstr

變數的指標，接收 dispID中所識別屬性的顯示名稱。這個方法會使用 SysAllocString 配置字串。傳回時，字串是呼叫端的責任，當不再需要時，必須使用 SysFreeString 來釋放它。

這個方法可以傳回標準傳回值E_INVALIDARG、E_OUTOFMEMORY和E_UNEXPECTED，以及下列值。

傳回碼	描述
S_OK	已成功傳回顯示名稱。
E_NOTIMPL	物件不提供個別屬性的顯示名稱。呼叫端有一個檢查物件類型資訊，以取得物件在此案例中的文字名稱。
E_POINTER	pbstr 中的地址無效。例如，可能是 NULL。