Compartilhar via

Método IPortableDeviceContent2::UpdateObjectWithPropertiesAndData (portabledeviceapi.h)

  • Artigo

O método UpdateObjectWithPropertiesAndData atualiza um objeto usando propriedades e dados encontrados no dispositivo.

Sintaxe

HRESULT UpdateObjectWithPropertiesAndData(
  [in]      LPCWSTR               pszObjectID,
  [in]      IPortableDeviceValues *pProperties,
  [out]     IStream               **ppData,
  [in, out] DWORD                 *pdwOptimalWriteBufferSize
);

Parâmetros

[in] pszObjectID

O identificador do objeto a ser atualizado.

[in] pProperties

A interface IPortableDeviceValues que especifica as propriedades do objeto a serem atualizadas.

[out] ppData

A interface IStream pela qual os dados do objeto são enviados para o dispositivo.

[in, out] pdwOptimalWriteBufferSize

O tamanho ideal do buffer para gravar os dados do objeto em ppData ou NULL se o tamanho do buffer for ignorado.

Retornar valor

Se o método for bem-sucedido, ele retornará S_OK. Qualquer outro valor HRESULT indica que a chamada falhou.

Comentários

Formatos de dispositivo e formatos de objeto podem derivar algumas de suas propriedades de objeto dos próprios dados. Ou eles podem ter valores de propriedade que dependem dos dados. Por exemplo, uma faixa de música tem uma propriedade de duração especificada quando um aplicativo chama o método IPortableDeviceContent::CreateObjectWithPropertiesAndData . Se essa faixa for armazenada como um recurso padrão (WPD_RESOURCE_DEFAULT), o aplicativo poderá atualizá-la. Além disso, o aplicativo pode ter que atualizar a propriedade de duração. Esse método permite que o aplicativo execute as duas atualizações ao mesmo tempo.

Uma atualização está incompleta até que o método IStream::Commit seja chamado no objeto referenciado pelo parâmetro ppData .

Para abandonar uma transferência de dados em andamento, um aplicativo deve chamar o método IStream::Revert no objeto referenciado pelo parâmetro ppData .

O objeto de interface IStream referenciado pelo parâmetro ppData deve ser liberado depois que a operação de atualização for concluída ou cancelada.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 7 [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte Nenhum compatível
Plataforma de Destino Windows
Cabeçalho portabledeviceapi.h