Returns a comma separated list of filtered configuration section names. The filter is based on the config type of the section, if the configuration section matches the config type specified then it will appear on the list.

Parameters:

configType

The type of configuration being sought.

buffer

The buffer that will contain the comma separated list.

bufferLen

The size of the buffer (used to prevent an overrun).

Return Value:        

The number of characters that were copied into the buffer (including the termination character).

Prototype Signature:

int GetConfigTypeList(EConfigType configType, char* buffer, int bufferLen);


An example of how this function could be used is shown below.

If a list of FCMs is desired then one would use the function as such:

#include <malloc.h>
#include <string.h>
#include "api.h"

int main()
{
   success successful;
   int bufferLen = 1024;
   char* responseBuffer = malloc(bufferLen);
   int bytesCopied;

   //Initialize the library with a specific configuration file
   successful = Initialize("C:\\Temp\\MyConfig.ini");
   if(successful)
   {
       //Get the comma separated list of FCM configuration names
       bytesCopied = GetConfigTypeList(Fcm, responseBuffer, bufferLen);
   }
}