IProfileObject::get_Fields
.gif "Ee783855.c++_off(en-US,CS.10).gif")
.gif "Ee783855.vb_on(en-US,CS.10).gif")
The Fields property is a read-only Fields collection that contains the profile property data for the ProfileObject object. Read-only refers to the inability to add or delete members (profile properties) of the Fields collection. This property is the default property of the ProfileObject object. Use this property to set and retrieve profile property values and to navigate the attribute list of the properties.
Definition
HRESULT IProfileObject::get_Fields(Fields**ppFields);
Parameters
ppFields
[out, retval] The address of a pointer to a Fields collection used to return the profile object properties.
Return Values
This method returns an HRESULT indicating whether or not it completed successfully. See the following Error Values section for more details.
Error Values
The Errors property of the ProfileService object stores the collection of errors encountered in the last Profiles resource operation. For more information, see IProfileService::get_Errors.
Remarks
The Fields collection is similar to an ADO Fields collection object. The following ADO Fields methods and properties are supported:
Count
Item
_NewEnum
A member of the Fields collection is a Field object that represents a single property or property group of a ProfileObject object. The Field object is similar to an ADO Field object. The following ADO Field methods and properties are supported:
Properties - Returns the read-only Attributes collection.
DefinedSize - Retrieves the defined size of the data type.
Name
Type
Value
The Attributes collection is represented as an ADO Properties object. The following ADO Properties methods and properties are supported:
Count
Item
_NewEnum
Use the Update method of the ProfileObject object to save any changed profile data in the underlying data store.
The Fields property of the ProfileObject object supports extended dot notation for increased performance. For example, using extended dot notation, the following:
oProfileObject.Fields("Address.Zipcode")
is equivalent to:
oProfileObject.Fields("Address").Value("Zipcode")
For information about memory ownership issues related to COM property and method parameters, see Managing COM Parameter Memory.
The ppFields parameter contains valid data only if the property is accessed successfully.