Método IPortableDeviceProperties::D elete (portabledeviceapi.h)

O método Delete exclui as propriedades especificadas de um objeto especificado em um dispositivo.

Sintaxe

HRESULT Delete(
  [in] LPCWSTR                      pszObjectID,
  [in] IPortableDeviceKeyCollection *pKeys
);

Parâmetros

[in] pszObjectID

Ponteiro para uma cadeia de caracteres terminada em nulo que especifica a ID do objeto cujas propriedades você excluirá. Para especificar o dispositivo, use WPD_DEVICE_OBJECT_ID.

[in] pKeys

Ponteiro para uma interface IPortableDeviceKeyCollection que especifica quais propriedades excluir. Para obter uma lista de propriedades definidas por Dispositivos Portáteis do Windows, consulte Propriedades e Atributos.

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.
S_FALSE	Não foi possível excluir um ou mais valores de propriedade.
E_POINTER	O argumento de ponteiro necessário era NULL.

Comentários

As propriedades só poderão ser excluídas se o atributo WPD_PROPERTY_ATTRIBUTE_CAN_DELETE for True. Esse atributo pode ser recuperado chamando GetPropertyAttributes.

O driver não tem como indicar êxito parcial; ou seja, se apenas algumas propriedades puderem ser excluídas, o driver retornará S_FALSE, mas esse método não indicará quais propriedades foram excluídas com êxito. A única maneira de saber quais propriedades foram excluídas é solicitar todas as propriedades chamando IPortableDeviceProperties::GetValues.

Requisitos

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

Confira também

IPortableDeviceProperties Interface