Skip to content

Latest commit

 

History

History
116 lines (78 loc) · 4.88 KB

nf-propidl-ipropertystorage-readmultiple.md

File metadata and controls

116 lines (78 loc) · 4.88 KB
UID title description helpviewer_keywords old-location tech.root ms.assetid ms.date ms.keywords req.header req.include-header req.target-type req.target-min-winverclnt req.target-min-winversvr req.kmdf-ver req.umdf-ver req.ddi-compliance req.unicode-ansi req.idl req.max-support req.namespace req.assembly req.type-library req.lib req.dll req.irql targetos req.typenames req.redist ms.custom f1_keywords dev_langs topic_type api_type api_location api_name
NF:propidl.IPropertyStorage.ReadMultiple
IPropertyStorage::ReadMultiple (propidl.h)
The IPropertyStorage::ReadMultiple method reads specified properties from the current property set.
IPropertyStorage [Strctd Stg]
ReadMultiple
IPropertyStorage interface [Structured Storage]
ReadMultiple method
IPropertyStorage.ReadMultiple
IPropertyStorage::ReadMultiple
ReadMultiple
ReadMultiple method [Structured Storage]
ReadMultiple method [Structured Storage]
IPropertyStorage interface
_stg_ipropertystorage_readmultiple
propidl/IPropertyStorage::ReadMultiple
stg.ipropertystorage_readmultiple
stg\ipropertystorage_readmultiple.htm
Stg
a3d708fe-53af-4f1b-94ac-edc40d59a034
08/02/2022
IPropertyStorage [Strctd Stg],ReadMultiple, IPropertyStorage interface [Structured Storage],ReadMultiple method, IPropertyStorage.ReadMultiple, IPropertyStorage::ReadMultiple, ReadMultiple, ReadMultiple method [Structured Storage], ReadMultiple method [Structured Storage],IPropertyStorage interface, _stg_ipropertystorage_readmultiple, propidl/IPropertyStorage::ReadMultiple, stg.ipropertystorage_readmultiple
propidl.h
Objbase.h, Propidlbase.h
Windows
Windows 2000 Professional [desktop apps \| UWP apps]
Windows 2000 Server [desktop apps \| UWP apps]
Uuid.lib
Ole32.dll
Windows
19H1
IPropertyStorage::ReadMultiple
propidl/IPropertyStorage::ReadMultiple
c++
APIRef
kbSyntax
COM
Ole32.dll
IPropertyStorage.ReadMultiple

IPropertyStorage::ReadMultiple

-description

The ReadMultiple method reads specified properties from the current property set.

-parameters

-param cpspec [in]

The numeric count of properties to be specified in the rgpspec array. The value of this parameter can be set to zero; however, that defeats the purpose of the method as no properties are thereby read, regardless of the values set in rgpspec.

-param rgpspec [in]

An array of PROPSPEC structures specifies which properties are read. Properties can be specified either by a property ID or by an optional string name. It is not necessary to specify properties in any particular order in the array. The array can contain duplicate properties, resulting in duplicate property values on return for simple properties. Nonsimple properties should return access denied on an attempt to open them a second time. The array can contain a mixture of property IDs and string IDs.

-param rgpropvar [out]

Caller-allocated array of a PROPVARIANT structure that, on return, contains the values of the properties specified by the corresponding elements in the rgpspec array. The array must be at least large enough to hold values of the cpspec parameter of the PROPVARIANT structure. The cpspec parameter specifies the number of properties set in the array. The caller is not required to initialize these PROPVARIANT structure values in any specific order. However, the implementation must fill all members correctly on return. If there is no other appropriate value, the implementation must set the vt member of each PROPVARIANT structure to VT_EMPTY.

-returns

This method supports the standard return value E_UNEXPECTED, as well as the following:

This function can also return any file system errors or Win32 errors wrapped in an HRESULT data type. For more information, see Error Handling Strategies.

For more information, see Property Storage Considerations.

-see-also

EnumAll Sample

IPropertySetStorage

IPropertyStorage

IPropertyStorage::WriteMultiple

IPropertyStorage::WritePropertyNames

Samples

StgCreatePropSetStg Sample

WriteRead Sample