db2secFreeGroupListMemory (API) - Speicher für Gruppenliste freigeben

Gibt den Speicher frei, der zum Speichern der Liste der Gruppen aus einem vorherigen Aufruf an die db2secGetGroupsForUser -API verwendet wurde.

API- und Datenstruktursyntax

     SQL_API_RC ( SQL_API_FN *db2secFreeGroupListMemory) 
                           ( void *ptr,
                             char      **errormsg,
                             db2int32 *errormsglen );

Parameter der API 'db2secFreeGroupListMemory'

ptr: Eingabe. Verweis auf den freizugebenden Speicher.
errormsg: Ausgabe. Ein Zeiger auf die Adresse einer vom Plug-in zugeordneten ASCII-Fehlernachrichtenzeichenfolge, die in diesem Parameter zurückgegeben wird, wenn die db2secFreeGroupListMemory -API-Ausführung nicht erfolgreich ist.
errormsglen: Ausgabe. Ein Verweis auf einen ganzzahligen Wert (Integer), der die Länge (in Byte) der Fehlernachrichtenzeichenfolge im Parameter errormsg angibt.