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

O método CreateObjectWithPropertiesOnly cria um objeto com apenas propriedades no dispositivo.

Sintaxe

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

Parâmetros

pValues

Uma coleção IPortableDeviceValues de propriedades a serem atribuídas ao objeto. Para obter uma lista de propriedades obrigatórias e opcionais para um objeto, consulte Requisitos para objetos.

[in, out] ppszObjectID

Um ponteiro de cadeia de caracteres opcional para receber o nome do novo objeto. Pode ser NULL, se não necessário. Dispositivos Portáteis do Windows define a constante WPD_DEVICE_OBJECT_ID para representar um dispositivo. O SDK aloca essa memória; o chamador deve liberá-lo usando CoTaskMemFree.

Retornar valor

O método retorna um HRESULT. Os possíveis valores incluem, mas sem limitação, aqueles na tabela a seguir.

Código de retorno	Descrição
S_OK	O método foi bem-sucedido.
E_POINTER	Pelo menos um dos argumentos necessários era um ponteiro NULL .

Comentários

Alguns objetos são apenas uma coleção de propriedades, como uma pasta, que é apenas uma coleção de ponteiros para outros objetos, enquanto outros objetos são propriedades e dados, como um arquivo de áudio, que contém todas as propriedades e os bits de música reais. Esse método é usado para criar um objeto que contém apenas propriedades. Para criar um objeto com propriedades e dados, use CreateObjectWithPropertiesAndData.

Esse método é síncrono; quando ele retorna, o novo objeto deve estar presente no dispositivo.

O objeto que o driver realmente cria pode ser um objeto de propriedades e dados, dependendo do tipo de objeto mais conveniente para o driver. Para marcar que tipo de objeto o driver criou, solicite a propriedade WPD_OBJECT_FORMAT do novo objeto.

O objeto será criado no dispositivo quando esse método retornar.

Exemplos

Para obter um exemplo de como usar esse método, consulte Transferindo um objeto Properties-Only para o dispositivo.

Requisitos

Requisito	Valor
Plataforma de Destino	Windows
Cabeçalho	portabledeviceapi.h
Biblioteca	PortableDeviceGUIDs.lib

Confira também

IPortableDeviceContent Interface

Transferindo um objeto Properties-Only para o dispositivo