共用方式為

IPerPropertyBrowsing：：GetPredefinedValue 方法 (ocidl.h)

  • 發行項

擷取與預先定義字串名稱相關聯的指定屬性值。 此屬性與從 IPerPropertyBrowsing：：GetPredefinedStrings 傳回的預先定義字串名稱相關聯。 預先定義的字串是由 從 GetPredefinedStrings 傳回的令牌來識別。

語法

HRESULT GetPredefinedValue(
  [in]  DISPID  dispID,
  [in]  DWORD   dwCookie,
  [out] VARIANT *pVarOut
);

參數

[in] dispID

要求預先定義值之屬性的分派標識碼。

[in] dwCookie

令牌，識別要傳回的值。 令牌先前在由 GetPredefinedStrings 填入的 pCaCookiesOut 陣列中傳回。

[out] pVarOut

屬性之 VARIANT 值的指標。

傳回值

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

傳回碼 描述
S_OK
 已成功完成命令。
E_NOTIMPL
 此物件不支援預先定義的字串或預先定義的值。
E_POINTER
 pVarOut 中的位址無效。 例如，它可能是 NULL。

備註

來電者附註

呼叫端負責釋放 VARIANT 中包含的任何配置。 除非 VARIANT 的 vt 成員VT_VARIANT，否則呼叫者可以使用對 VariantClear 的單一呼叫來釋放記憶體。 否則，呼叫端必須先遞歸釋放包含的 VARIANT 值，再釋放外部 VARIANT。

實作者的注意事項

不需要預先定義的名稱和值支援。 如果您的物件不支援這些名稱，請從此方法傳回E_NOTIMPL。 如果未實作這個方法，則不得實作 IPerPropertyBrowsing：：GetPredefinedStrings 。

這個方法會配置 VARIANT 內所需的任何記憶體。

規格需求

需求 值
最低支援的用戶端 Windows 2000 Professional [僅限傳統型應用程式]
最低支援的伺服器 Windows 2000 Server [僅限桌面應用程式]
目標平台 Windows
標頭 ocidl.h

另請參閱

IPerPropertyBrowsing