IProfileService::GetProfileDefXML
.gif "Ee799188.c++_off(en-US,CS.10).gif")
.gif "Ee799188.vb_on(en-US,CS.10).gif")
Use this method to retrieve the XML definition of the named profile schema type.
Definition
HRESULT IProfileService::GetProfileDefXML(BSTRbstrProfileName,VARIANT_BOOLbNamesOnly,BSTR*pbstrXML);
Parameters
bstrProfileName
[in] A BSTR that contains the name of the profile schema type.
bNamesOnly
[in] A VARIANT_BOOL that determines whether the method returns the profile schema name or the profile schema definition. A value of FALSE indicates to return the profile definition. A value of TRUE indicates to return only the name of the profile schema.
pbstrXML
[out, retval] A pointer to a BSTR that will contain the XML description.
Return Values
This method returns an HRESULT indicating whether it completed successfully. See the Error Values section for more details.
Error Values
The Errors property stores the collection of errors encountered in the last Profiles resource operation. For more information, see IProfileService::get_Errors.
Remarks
If the bstrProfileName parameter is empty and the bNamesOnly parameter is False (0), the XML descriptions of all the schema types in the catalog are returned.
If the bstrProfileName parameter is empty and the bNamesOnly parameter is True (-1), the names of all the schema types in the catalog are returned.
For information about the XML definitions, see the Profile XML Structures topic.
Call the Initialize method before you use this ProfileService method.
For more information about memory ownership issues related to COM property and method parameters, see Managing COM Parameter Memory.
The pbstrXML parameter contains valid data only if the method completes successfully.