db2secDoesAuthIDExist (API) - Vorhandensein der Berechtigungs-ID überprüfen

Ermittelt, ob authid einen einzelnen Benutzer darstellt (z. B. ob die API authid einer externen Benutzer-ID zuordnen kann).

Die API sollte den Wert DB2SEC_PLUGIN_OK zurückgeben, wenn sie erfolgreich ist-die authid ist gültig, DB2SEC_PLUGIN_INVALID_USERORGROUP , wenn sie nicht gültig ist, oder DB2SEC_PLUGIN_USERSTATUSNOTKNOWN , wenn die authid -Existenz nicht bestimmt werden kann.

API- und Datenstruktursyntax

     SQL_API_RC ( SQL_API_FN *db2secDoesAuthIDExist) 
                           ( const char *authid,
                             db2int32 authidlen,
                             char       **errormsg,
                             db2int32 *errormsglen );

Parameter der API 'db2secDoesAuthIDExist'

authid
Eingabe. Die zu überprüfende Berechtigungs-ID. Dieser Wert liegt in Großbuchstaben und ohne folgende Leerzeichen vor.
authidlen
Eingabe. Die Länge (in Byte) des Werts des Parameters authid.
errormsg
Ausgabe. Ein Zeiger auf die Adresse einer vom Plug-in zugeordneten ASCII-Fehlernachrichtenzeichenfolge, die in diesem Parameter zurückgegeben wird, wenn die db2secDoesAuthIDExist -API-Ausführung nicht erfolgreich ist.
errormsglen
Ausgabe. Ein Verweis auf einen ganzzahligen Wert (Integer), der die Länge der Fehlernachrichtenzeichenfolge im Parameter errormsg angibt.