AutoCAD Map 3D 2009 Geospatial Platform Reference

AutoCAD Map 3D Geospatial Platform API

virtual MgStringCollection* MgFeatureService::GetConnectionPropertyValues ( CREFSTRING  providerName,
CREFSTRING  propertyName,
CREFSTRING  partialConnString 
) [pure virtual]

Gets a set of connection values that are used to make connections to an FDO provider that permits multiple connections.

Remarks:
You connect to the provider using a set of values that is one value short of addressing a source of feature data. This set of values is also known as a "partial connection string". The provider returns a set of values each of which represents a final value needed to connect to feature data. You can now construct a set of "full connection strings", and you can test the validity of each of these using the MgFeatureService::TestConnection Method . You make a fully functional connection using another variant of the MgFeatureService::TestConnection Method . Currently, the only use for this method is to list the datastores in an Oracle database. Feature data is stored in a datastore in an Oracle database. This is explained in the section on the Oracle provider in the Connection To Feature Source topic.
.NET Syntax
virtual MgStringCollection GetConnectionPropertyValues(string providerName, string propertyName, string partialConnString);
Java Syntax
virtual MgStringCollection GetConnectionPropertyValues(String providerName, String propertyName, String partialConnString);
PHP Syntax
virtual MgStringCollection GetConnectionPropertyValues(string providerName, string propertyName, string partialConnString);

Parameters:
providerName (String/string) The name of the Fdo feature provider. Permissible values are obtained by calling the MgFeatureService::GetFeatureProviders Method .
propertyName (String/string) The name of the enumerable property for which values need to be retrieved. Connection property names are contained in the output of the MgFeatureService::GetFeatureProviders method. The value of the ConnectionProperty element's Enumerable attribute must be true.
partialConnString (String/string) A partial connection string, which is sufficient to connect to a provider.
Returns:
Returns an MgStringCollection or NULL, if nothing is found.
Examples (PHP)
 $datastores = $featureService->GetConnectionPropertyValues("Autodesk.Oracle", "DataStore", "Service=MapGuideService;Username=MapGuideUser;Password=test;DataStore=");

Exceptions:
MgInvalidArgumentException 
MgFdoException