db2secDoesGroupExist API - 检查组是否存在

确定 authid 是否表示一个组。

如果 groupname 存在，那么此 API 必须能够返回值 DB2SEC_PLUGIN_OK 以指示成功。 如果组名无效，那么它还必须能够返回值 DB2SEC_PLUGIN_INVALIDUSERORGROUP。 如果不能确定输入是否是有效的组，那么允许此 API 返回值 DB2SEC_PLUGIN_GROUPSTATUSNOTKNOWN。 如果返回了“组无效”（DB2SEC_PLUGIN_INVALIDUSERORGROUP）或者“未知组”（DB2SEC_PLUGIN_GROUPSTATUSNOTKNOWN）值，那么在不带关键字 USER 和 GROUP 的情况下发出 GRANT 语句时，DB2 可能无法确定 authid 是一个组还是用户，这将导致对用户返回 SQLCODE -569 或 SQLSTATE 56092 错误。

API 和数据结构语法

     SQL_API_RC ( SQL_API_FN *db2secDoesGroupExist) 
                           ( const char *groupname,
                             db2int32 groupnamelen,
                             char      **errormsg,
                             db2int32 *errormsglen );

db2secDoesGroupExist API 参数

groupname
输入。 一个授权标识，采用大写，并且没有尾部空格。
groupnamelen
输入。 groupname 参数值的长度（以字节计）。
errormsg
输出。 指向由插件分配的 ASCII 错误消息字符串地址的指针，如果执行 db2secDoesGroupExist API 不成功，就会返回此错误消息。
errormsglen
输出。 指向一个用于指示 errormsg 参数中的错误消息字符串长度（以字节计）的整数的指针。