Método IPropertyStorage::D eleteMultiple (propidl.h)

O método DeleteMultiple exclui quantas propriedades indicadas existirem nesse conjunto de propriedades.

Sintaxe

HRESULT DeleteMultiple(
  [in] ULONG             cpspec,
  [in] const PROPSPEC [] rgpspec
);

Parâmetros

[in] cpspec

A contagem numérica de propriedades a serem excluídas. O valor desse parâmetro pode ser definido legalmente como zero, no entanto, isso derrota a finalidade do método, pois nenhuma propriedade é excluída, independentemente do valor definido em rgpspec.

[in] rgpspec

Propriedades a serem excluídas. Uma combinação de identificadores de propriedade e propriedades nomeadas por cadeia de caracteres é permitida. Pode haver duplicatas e não há nenhum requisito de que as propriedades sejam especificadas em qualquer ordem.

Retornar valor

Esse método dá suporte ao valor retornado padrão E_UNEXPECTED, além do seguinte:

Comentários

IPropertyStorage::D eleteMultiple deve excluir quantas propriedades indicadas estiverem no conjunto de propriedades atual. Se ocorrer uma exclusão de uma propriedade com valor de fluxo ou armazenamento enquanto essa propriedade estiver aberta, a exclusão terá êxito e colocará o ponteiro IStream ou IStorage retornado anteriormente no estado revertido.

Requisitos