Método IPropertyStorage::ReadPropertyNames (propidl.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 .
Retornar valor
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
| 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 | propidl.h (inclua Objbase.h, Propidlbase.h) |
| Biblioteca | Uuid.lib |
| DLL | Ole32.dll |