MDAC 2.5 SDK - OLE DB Programmer's Reference
Chapter 14: Properties


 

DBPROPIDSET Structure

Consumers use DBPROPIDSET structures to pass an array of property IDs for which the consumer wants to get values or information. The properties identified in a single DBPROPIDSET structure all belong to the same property set.

The DBPROPIDSET structure is defined as:

typedef struct tagDBPROPIDSET {
   DBPROPID *   rgPropertyIDs;
   ULONG        cPropertyIDs
   GUID         guidPropertySet;
} DBPROPIDSET;

The elements of this structure are described in the following table.

Element Description
rgPropertyIDs A pointer to an array of property IDs for which to return values or information. If cPropertyIDs is zero, this is ignored.
cPropertyIDs The number of properties from the property set for which to return values or information. If cPropertyIDs is zero, the method ignores rgPropertyIDs and returns values for or information about all of the properties in the property set.
guidPropertySet A GUID that identifies the property set to which the properties belong.

If the provider does not support this property set, the method to which this is passed returns DB_S_ERRORSOCCURRED or DB_E_ERRORSOCCURRED. If cPropertyIDs is zero, the method sets cProperties and rgProperties in the corresponding DBPROPSET structure or cPropertyInfos and rgPropertyInfos in the corresponding DBPROPINFOSET structure to zero and a null pointer, respectively. If cPropertyIDs is not zero, then for each property specified in rgPropertyIDs, the method sets dwStatus in the corresponding DBPROP structure to DBPROPSTATUS_NOTSUPPORTED or dwFlags in the corresponding DBPROPINFO structure to DBPROPFLAGS_NOTSUPPORTED.