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

El método ReadPropertyNames recupera los nombres de cadena existentes para los identificadores de propiedad especificados.

Sintaxis

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

Parámetros

[in] cpropid

Número de elementos en la entrada del rgpropid de la matriz. El valor de este parámetro se puede establecer en cero, sin embargo, que derrota el propósito de este método, ya que no se leen nombres de propiedad.

[in] rgpropid

Matriz de identificadores de propiedad para los que se van a recuperar los nombres.

[in, out] rglpwstrName

Matriz asignada por el autor de la llamada de tamaño cpropid de miembros LPWSTR . A cambio, la implementación rellena esta matriz. Una entrada determinada contiene el nombre de cadena correspondiente de un identificador de propiedad o puede estar vacío si el identificador de propiedad no tiene nombres de cadena.

Cada miembro LPWSTR de la matriz debe liberarse mediante la función CoTaskMemFree .

Valor devuelto

Este método admite el valor devuelto estándar E_UNEXPECTED, además de lo siguiente:

Comentarios

Para cada identificador de propiedad de la lista de identificadores de propiedad proporcionados en la matriz rgpropid , ReadPropertyNames recupera el nombre de cadena correspondiente, si hay uno. Los nombres de cadena se crean especificando los nombres en llamadas a IPropertyStorage::WriteMultiple al crear la propiedad, o a través de una llamada a IPropertyStorage::WritePropertyNames. En cualquier caso, el nombre de cadena es opcional, pero todas las propiedades deben tener un identificador de propiedad.

Los nombres de cadena asignados a los identificadores de propiedad deben ser únicos dentro del conjunto.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional [aplicaciones de escritorio | Aplicaciones para UWP]
Servidor mínimo compatible	Windows 2000 Server [aplicaciones de escritorio | Aplicaciones para UWP]
Plataforma de destino	Windows
Encabezado	propidl.h (include Objbase.h, Propidlbase.h)
Library	Uuid.lib
Archivo DLL	Ole32.dll

Consulte también

IPropertyStorage

IPropertyStorage::WriteMultiple

IPropertyStorage::WritePropertyNames