Método IPortableDeviceProperties::GetPropertyAttributes (portabledeviceapi.h)

El método GetPropertyAttributes recupera atributos de una propiedad de objeto especificada en un dispositivo.

Sintaxis

HRESULT GetPropertyAttributes(
  [in]  LPCWSTR               pszObjectID,
  [in]  REFPROPERTYKEY        Key,
  [out] IPortableDeviceValues **ppAttributes
);

Parámetros

[in] pszObjectID

Puntero a una cadena terminada en null que contiene el identificador de objeto del objeto que se va a consultar. Para especificar el dispositivo, use WPD_DEVICE_OBJECT_ID.

[in] Key

REFPROPERTYKEY que especifica la propiedad para la que se va a consultar. Puede recuperar una lista de propiedades admitidas llamando a GetSupportedProperties. Para obtener una lista de las propiedades definidas por dispositivos portátiles de Windows, vea Propiedades y atributos.

[out] ppAttributes

Dirección de una variable que recibe un puntero a una interfaz IPortableDeviceValues que contiene los atributos de propiedad recuperados. Estos son pares PROPERTYKEY/value, donde PROPERTYKEY es la propiedad y el tipo de datos value depende de la propiedad específica. El autor de la llamada debe liberar esta interfaz cuando haya terminado con ella. Los atributos definidos por dispositivos portátiles de Windows se pueden encontrar en la página Propiedades y atributos .

Valor devuelto

El método devuelve un valor HRESULT. Entre los valores posibles se incluyen los que se indican en la tabla siguiente, entre otros.

Código devuelto	Descripción
S_OK	El método se realizó correctamente y todos los atributos se recuperaron correctamente.
S_FALSE	Solo se podrían recuperar algunos valores de atributo. Otros no pudieron y contendrán un valor HRESULT de tipo VT_ERROR.
E_POINTER	Un argumento de puntero requerido era NULL.

Comentarios

Los atributos de propiedad describen los derechos de acceso de una propiedad, los valores válidos y otra información. Por ejemplo, una propiedad puede tener un valor de WPD_PROPERTY_ATTRIBUTE_CAN_DELETE establecido en False para evitar la eliminación y tener un intervalo de valores válidos almacenados como entradas individuales.

Ejemplos

Para obtener un ejemplo de cómo usar este método, vea Establecer propiedades para un único objeto.

Requisitos

Requisito	Value
Plataforma de destino	Windows
Encabezado	portabledeviceapi.h
Library	PortableDeviceGUIDs.lib

Consulte también

IPortableDeviceProperties (interfaz)

Establecer propiedades para un único objeto

Escribir propiedades de content-object