Método IPortableDeviceContent::CreateObjectWithPropertiesOnly (portabledeviceapi.h)

El método CreateObjectWithPropertiesOnly crea un objeto con solo propiedades en el dispositivo.

Sintaxis

HRESULT CreateObjectWithPropertiesOnly(
            IPortableDeviceValues *pValues,
  [in, out] LPWSTR                *ppszObjectID
);

Parámetros

pValues

Colección IPortableDeviceValues de propiedades que se van a asignar al objeto . Para obtener una lista de las propiedades obligatorias y opcionales de un objeto, vea Requirements for Objects.

[in, out] ppszObjectID

Puntero de cadena opcional para recibir el nombre del nuevo objeto. Puede ser NULL, si no es necesario. Dispositivos portátiles de Windows define la constante WPD_DEVICE_OBJECT_ID para representar un dispositivo. El SDK asigna esta memoria; el autor de la llamada debe liberarlo con CoTaskMemFree.

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 ha llevado a cabo de forma correcta.
E_POINTER	Al menos uno de los argumentos necesarios era un puntero NULL .

Comentarios

Algunos objetos son solo una colección de propiedades, como una carpeta, que es solo una colección de punteros a otros objetos, mientras que otros objetos son propiedades y datos, como un archivo de audio, que contiene todas las propiedades y los bits de música reales. Este método se usa para crear un objeto que contiene solo propiedades. Para crear un objeto con propiedades y datos, use CreateObjectWithPropertiesAndData.

Este método es sincrónico; cuando se devuelve, el nuevo objeto debe estar presente en el dispositivo.

El objeto que realmente crea el controlador puede ser un objeto properties-and-data, dependiendo de qué tipo de objeto sea más conveniente para el controlador. Para comprobar qué tipo de objeto ha creado el controlador, solicite la propiedad WPD_OBJECT_FORMAT del nuevo objeto.

El objeto se creará en el dispositivo cuando este método vuelva.

Ejemplos

Para obtener un ejemplo de cómo usar este método, consulte Transferencia de un objeto Properties-Only al dispositivo.

Requisitos

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

Consulte también

IPortableDeviceContent (Interfaz)

Transferencia de un objeto Properties-Only al dispositivo