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 |