Método IPropertySystem::GetPropertyDescriptionByName (propsys.h)

Obtiene una instancia del objeto subsistema que implementa IPropertyDescription, para obtener la descripción de la propiedad para un nombre canónico determinado.

Sintaxis

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

Parámetros

[in] pszCanonicalName

Tipo: LPCWSTR

Puntero a una cadena que identifica la propiedad .

[in] riid

Tipo: REFIID

Referencia al IID deseado.

[out] ppv

Tipo: void**

Dirección de un puntero de interfaz IPropertyDescription .

Valor devuelto

Tipo: PSSTDAPI

Devuelve uno de los valores siguientes.

Código devuelto	Descripción
S_OK	Indica que se obtiene la interfaz.
E_INVALIDARG	Indica que pszCanonicalName es NULL.
TYPE_E_ELEMENTNOTFOUND	Indica que el nombre canónico no existe en la memoria caché del subsistema de esquema.

Comentarios

Se recomienda usar la macro IID_PPV_ARGS, definida en objbase.h, para empaquetar los parámetros riid y ppv . Esta macro proporciona el IID correcto basado en la interfaz a la que apunta el valor en ppv, lo que elimina la posibilidad de un error de codificación.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows XP con SP2, Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 con SP1 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	propsys.h
Archivo DLL	Propsys.dll (versión 5.0 o posterior)
Redistribuible	Búsqueda de escritorio de Windows (WDS) 3.0

Consulte también

IPropertySystem