IPropertySystem::GetPropertyDescriptionByName 方法 (propsys.h)

取得實作 IPropertyDescription 之子系統對象的實例,以取得指定標準名稱的屬性描述。

語法

HRESULT GetPropertyDescriptionByName(
  [in]  LPCWSTR pszCanonicalName,
  [in]  REFIID  riid,
  [out] void    **ppv
);

參數

[in] pszCanonicalName

類型: LPCWSTR

識別屬性之字串的指標。

[in] riid

類型: REFIID

所需 IID 的參考。

[out] ppv

類型: void**

IPropertyDescription 介面指標的位址。

傳回值

類型: PSSTDAPI

傳回下列其中一個值。

傳回碼 描述
S_OK
表示已取得介面。
E_INVALIDARG
表示 pszCanonicalNameNULL
TYPE_E_ELEMENTNOTFOUND
表示架構子系統快取中不存在標準名稱。

備註

建議您使用 objbase.h 中定義的 IID_PPV_ARGS 宏來封裝 riidppv 參數。 此宏會根據 ppv 中值所指向的介面提供正確的 IID,消除編碼錯誤的可能性。

規格需求

需求
最低支援的用戶端 Windows XP 搭配 SP2、Windows Vista [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2003 SP1 [僅限傳統型應用程式]
目標平台 Windows
標頭 propsys.h
Dll Propsys.dll (5.0 版或更新版本)
可轉散發套件 Windows 桌面搜尋 (WDS) 3.0

另請參閱

IPropertySystem