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，以及下列值。

呼叫端負責釋放 VARIANT 中包含的任何配置。 除非 VARIANT 的 vt 成員VT_VARIANT，否則呼叫者可以使用對 VariantClear 的單一呼叫來釋放記憶體。 否則，呼叫端必須先遞歸釋放包含的 VARIANT 值，再釋放外部 VARIANT。 不需要預先定義的名稱和值支援。 如果您的物件不支援這些名稱，請從此方法傳回E_NOTIMPL。 如果未實作這個方法，則不得實作 IPerPropertyBrowsing：：GetPredefinedStrings 。

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

IPerPropertyBrowsing