Syntax
#include <dlfcn.h> |
char *dlerror(void); |
Für den Aufruf in einer ASCII-Umgebung müssen Sie die Funktion __dlerror_ascii() mit denselben Parametern verwenden.
Beschreibung
dlerror() gibt eine mit binär Null endende Zeichenfolge ohne abschließendes Zeilenvorschubzeichen zurück. Diese Zeichenfolge beschreibt den letzten Fehler, der während der Verarbeitung von dynamischen Bindeaufrufen aufgetreten ist. Wenn seit dem letzten Aufruf von dlerror() keine Fehler beim dynamischen Binden aufgetreten sind, dann wird gibt dlerror() der Wert NULL zurück. Daher wird bei einem zweiten Aufruf von dlerror() direkt nach einem vorangegangenen Aufruf immer der Wert NULL zurückgegeben.
Returnwert
Bei erfolgreicher Ausführung gibt dlerror() eine auf binär Null endende Zeichenfolge zurück. Andernfalls wird der Wert NULL zurückgegeben.
Die Variable errno wird nicht gesetzt.
Hinweis
Die von dlerror() zurückgegebenen Informationen können sich in einem statischen Puffer befinden, der bei jedem Aufruf von dlerror() überschrieben wird. Anwendungscode sollte nicht in diesen Puffer geschrieben werden. Programme, die eine Fehlernachricht aufbewahren möchten, sollten eine eigene Kopie der Nachricht erstellen.
Siehe auch
dlclose(), dlopen(), dlsym()