db2secDoesAuthIDExist API - Check if authentication ID exists

Determines if the authid represents an individual user (for example, whether the API can map the authid to an external user ID).

The API should return the value DB2SEC_PLUGIN_OK if it is successful - the authid is valid, DB2SEC_PLUGIN_INVALID_USERORGROUP if it is not valid, or DB2SEC_PLUGIN_USERSTATUSNOTKNOWN if the authid existence cannot be determined.

API and data structure syntax

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

db2secDoesAuthIDExist API parameters

authid: Input. The authid to validate. This is upper-cased, with no trailing blanks.
authidlen: Input. Length in bytes of the authid parameter value.
errormsg: Output. A pointer to the address of an ASCII error message string allocated by the plug-in that can be returned in this parameter if the db2secDoesAuthIDExist API execution is not successful.
errormsglen: Output. A pointer to an integer that indicates the length of the error message string in errormsg parameter.