Diese Funktion weist allen Variablen, die in den Deskriptoren von sqlda beschrieben sind, Speicherplatz zu und ordnet die Speicheradressen dem Feld sqlda des entsprechenden Deskriptors zu. Es wird
genügend Speicherplatz zugewiesen für den im Deskriptor angegebenen Datenbanktyp und die angegebene Länge.
Die SQLDA sollte mit der Funktion free_filled_sqlda freigegeben werden.
Ein Parameter-Bit wird unterstützt: FILL_SQLDA_FLAG_RETURN_DT_LONG. Dieser Parameter wird in sqlca.h definiert.
FILL_SQLDA_FLAG_RETURN_DT_LONG behält die Datentypen DT_LONGVARCHAR, DT_LONGNVARCHAR und DT_LONGBINARY im ausgefüllten Deskriptor
bei. Wenn dieses Parameter-Bit nicht angegeben wird, konvertiert fill_sqlda_ex die Datentypen DT_LONGVARCHAR, DT_LONGNVARCHAR
und DT_LONGBINARY in DT_VARCHAR, DT_NVARCHAR und DT_BINARY. Die Verwendung der Typen DT_LONGxyz ermöglicht das Abrufen von 32767 Byte, und nicht der 32765 Byte, auf die DT_VARCHAR, DT_NVARCHAR und DT_BINARY beschränkt
sind.
fill_sqlda( SQLDA ) ist gleichwertig mit fill_sqlda_ex( sqlda, 0 ).