Método IPerPropertyBrowsing::GetPredefinedValue (ocidl.h)

Recupera el valor de la propiedad especificada asociada a un nombre de cadena predefinido. Esta propiedad está asociada a un nombre de cadena predefinido tal como se devuelve de IPerPropertyBrowsing::GetPredefinedStrings. La cadena predefinida se identifica mediante un token devuelto por GetPredefinedStrings.

Sintaxis

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

Parámetros

[in] dispID

Identificador de distribución de la propiedad para la que se solicita un valor predefinido.

[in] dwCookie

Token que identifica qué valor se va a devolver. El token se devolvió anteriormente en la matriz pCaCookiesOut rellenada por GetPredefinedStrings.

[out] pVarOut

Puntero al valor VARIANT de la propiedad .

Valor devuelto

Este método puede devolver los valores devueltos estándar E_INVALIDARG, E_OUTOFMEMORY y E_UNEXPECTED, así como los siguientes valores.

Código devuelto	Descripción
S_OK	El método se completó correctamente.
E_NOTIMPL	Este objeto no admite cadenas predefinidas ni valores predefinidos.
E_POINTER	La dirección de pVarOut no es válida. Por ejemplo, puede ser NULL.

Comentarios

Notas a los autores de llamadas

El autor de la llamada es responsable de liberar las asignaciones contenidas en variant. A menos que el miembro vt de VARIANT sea VT_VARIANT, el autor de la llamada puede liberar memoria mediante una sola llamada a VariantClear. De lo contrario, el autor de la llamada debe liberar de forma recursiva los valores VARIANT contenidos antes de liberar el VARIANT externo.

Notas para los implementadores

No se requiere compatibilidad con nombres y valores predefinidos. Si el objeto no admite estos nombres, devuelva E_NOTIMPL de este método. Si no se implementa este método, IPerPropertyBrowsing::GetPredefinedStrings tampoco se debe implementar.

Este método asigna cualquier memoria necesaria dentro de VARIANT.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	ocidl.h

Consulte también

IPerPropertyBrowsing