Compartilhar via

Método IPropertyStorage::D eletePropertyNames (propidlbase.h)

  • Artigo

O método DeletePropertyNames exclui os nomes de cadeia de caracteres especificados do conjunto de propriedades atual.

Sintaxe

HRESULT DeletePropertyNames(
  [in] ULONG           cpropid,
  [in] const PROPID [] rgpropid
);

Parâmetros

[in] cpropid

O tamanho na entrada da matriz rgpropid. Se 0, nenhum nome de propriedade será excluído.

[in] rgpropid

Identificadores de propriedade para os quais os nomes de cadeia de caracteres devem ser excluídos.

Retornar valor

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

Comentários

Para cada identificador de propriedade em rgpropid, IPropertyStorage::D eletePropertyNames remove qualquer mapeamento de ID de nome para propriedade correspondente. Uma tentativa é silenciosamente ignorada para excluir o nome de uma propriedade que não existe ou atualmente não tem um nome de cadeia de caracteres associado a ela. Esse método não tem efeito sobre as próprias propriedades.

Nota Todos os nomes de propriedade de cadeia de caracteres armazenadas podem ser excluídos excluindo o identificador de propriedade zero, mas cpropid deve ser igual a 1 para que esse seja um erro de parâmetro válido.
 

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 2000 Professional [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte Windows 2000 Server [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino Windows
Cabeçalho propidlbase.h (inclua Objbase.h, Propidlbase.h)
Biblioteca Uuid.lib
DLL Ole32.dll

Confira também

IPropertyStorage

IPropertyStorage::ReadPropertyNames