Método IPropertyStorage::ReadPropertyNames (propidlbase.h)

O método ReadPropertyNames recupera todos os nomes de cadeia de caracteres existentes para as IDs de propriedade especificadas.

Sintaxe

HRESULT ReadPropertyNames(
  [in]      ULONG           cpropid,
  [in]      const PROPID [] rgpropid,
  [in, out] LPOLESTR []     rglpwstrName
);

Parâmetros

[in] cpropid

O número de elementos na entrada da matriz rgpropid. O valor desse parâmetro pode ser definido como zero, no entanto, isso derrota a finalidade desse método, pois nenhum nome de propriedade é lido assim.

[in] rgpropid

Uma matriz de IDs de propriedade para as quais os nomes devem ser recuperados.

[in, out] rglpwstrName

Uma matriz alocada por chamador de cpropid de tamanho de membros LPWSTR . No retorno, a implementação preenche essa matriz. Uma determinada entrada contém o nome de cadeia de caracteres correspondente de uma ID de propriedade ou pode ficar vazia se a ID da propriedade não tiver nomes de cadeia de caracteres.

Cada membro LPWSTR da matriz deve ser liberado usando a função CoTaskMemFree .

Valor retornado

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

Comentários

Para cada ID de propriedade na lista de IDs de propriedade fornecidas na matriz rgpropid , ReadPropertyNames recupera o nome da cadeia de caracteres correspondente, se houver uma. Os nomes de cadeia de caracteres são criados especificando os nomes em chamadas para IPropertyStorage::WriteMultiple ao criar a propriedade ou por meio de uma chamada para IPropertyStorage::WritePropertyNames. Em ambos os casos, o nome da cadeia de caracteres é opcional, no entanto, todas as propriedades devem ter uma ID de propriedade.

Os nomes de cadeia de caracteres mapeados para IDs de propriedade devem ser exclusivos dentro do conjunto.

Requisitos

Confira também

IPropertyStorage

IPropertyStorage::WriteMultiple

IPropertyStorage::WritePropertyNames