Compartir a través de


Método IPropertyStorage::ReadPropertyNames (propidlbase.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, pero que anula 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 llamador 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 la 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

   
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 propidlbase.h (include Objbase.h, Propidlbase.h)
Library Uuid.lib
Archivo DLL Ole32.dll

Consulte también

IPropertyStorage

IPropertyStorage::WriteMultiple

IPropertyStorage::WritePropertyNames