Поделиться через

Метод IPerPropertyBrowsing::GetPredefinedValue (ocidl.h)

  • Статья

Извлекает значение указанного свойства, связанного с предопределенным строковым именем. Это свойство связано с предопределенным строковым именем, возвращенным из IPerPropertyBrowsing::GetPredefinedStrings. Предопределенная строка идентифицируется маркером, возвращенным из GetPredefinedStrings.

Синтаксис

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

Параметры

[in] dispID

Идентификатор диспетчеризации свойства, для которого запрашивается предопределенное значение.

[in] dwCookie

Маркер, определяющий возвращаемое значение. Ранее маркер был возвращен в массиве pCaCookiesOut , заполненном Командлетом GetPredefinedStrings.

[out] pVarOut

Указатель на значение VARIANT для свойства .

Возвращаемое значение

Этот метод может возвращать стандартные возвращаемые значения E_INVALIDARG, E_OUTOFMEMORY и E_UNEXPECTED, а также следующие значения.

Код возврата Описание
S_OK
 Метод завершился успешно.
E_NOTIMPL
 Этот объект не поддерживает предопределенные строки или предопределенные значения.
E_POINTER
 Недопустимый адрес в pVarOut . Например, он может иметь значение NULL.

Комментарии

Примечания к вызывающим абонентам

Вызывающий объект отвечает за освобождение всех выделений, содержащихся в VARIANT. Если член vtvariant не является VT_VARIANT, вызывающий объект может освободить память с помощью одного вызова VariantClear. В противном случае вызывающий объект должен рекурсивно освободить содержащиеся значения VARIANT перед освобождением внешнего объекта VARIANT.

Примечания для разработчиков

Поддержка предопределенных имен и значений не требуется. Если объект не поддерживает эти имена, верните E_NOTIMPL из этого метода. Если этот метод не реализован, IPerPropertyBrowsing::GetPredefinedStrings также не должен быть реализован.

Этот метод выделяет любую память, необходимую для variant.

Требования

Требование Значение
Минимальная версия клиента Windows 2000 Professional [только классические приложения]
Минимальная версия сервера Windows 2000 Server [только классические приложения]
Целевая платформа Windows
Header ocidl.h

См. также раздел

IPerPropertyBrowsing