db2secGroupPluginInit API-Inicializar plug-in do grupo

API de inicialização, para o plug-in de recuperação de grupo, que o gerenciador de banco de dados Db2® liga imediatamente após carregar o plug-in.

Sintaxe da API e da estrutura de dados

SQL_API_RC SQL_API_FN db2secGroupPluginInit
                              ( db2int32 version,
                                void *group_fns,
                                db2secLogMessage *logMessage_fn,
                                char     **errormsg,
                                db2int32 *errormsglen );

Parâmetros da API db2secGroupPluginInit

versão
Entrada. A versão mais alta da API suportada pela instância carregando esse plugin. O valor DB2SEC_API_VERSION (em db2secPlugin.h) contém o número de versão mais recente da API que o gerenciador de banco de dados Db2 suporta atualmente.
funções_de_grupo
Saída. Um ponteiro para a estrutura db2secGroupFunctions_<version_number> (também conhecida como group_functions_<version_number>). A estrutura db2secGroupFunctions_<version_number> contém ponteiros para as APIs implementadas para o plug-in de recuperação de grupo. No futuro, pode haver versões diferentes das APIs (por exemplo, db2secGroupFunctions_<version_number>), portanto, o parâmetro group_fns é lançado como um ponteiro para a estrutura db2secGroupFunctions_<version_number> correspondente à versão que o plug-in implementou. O primeiro parâmetro da estrutura group_functions_<version_number> informa Db2 a versão das APIs que o plug-in implementou. Nota: O casting é feito apenas se a versão Db2 for superior ou igual à versão das APIs que o plug-in implementou. O número da versão representa a versão das APIs implementada pelo plugin, e o pluginType deve ser configurado como DB2SEC_PLUGIN_TYPE_GROUP.
logMessage_fn
Entrada. Um ponteiro para a API db2secLogMessage , que é implementada pelo sistema de banco de dados Db2 . A API db2secGroupPluginInit pode chamar a API db2secLogMessage para registrar mensagens nos arquivos de log db2diag para fins de depuração ou informativos. O primeiro parâmetro (level) de db2secLogMessage API especifica o tipo de erros de diagnóstico que serão registrados nos arquivos de log db2diag e os dois últimos parâmetros são a string de mensagem e seu comprimento. Os valores válidos para o primeiro parâmetro de db2secLogMessage API (definido em db2secPlugin.h) são:
  • DB2SEC_LOG_NONE: (0) Sem registro
  • DB2SEC_LOG_CRITICAL: (1) Severo Erro encontrado
  • DB2SEC_LOG_ERROR: (2) Erro encontrado
  • DB2SEC_LOG_WARNING: (3) Aviso
  • DB2SEC_LOG_INFO: (4) Informativo
O texto da mensagem aparece nos arquivos de log db2diag apenas se o valor do parâmetro level da API db2secLogMessage for menor ou igual ao parâmetro de configuração do gerenciador de banco de dados diaglevel . Assim, por exemplo, se você usar o valor DB2SEC_LOG_INFO , o texto da mensagem aparece nos arquivos de log db2diag apenas se o parâmetro de configuração do gerenciador de banco de dados diaglevel estiver configurado como 4.
ERRORMSG
Saída. Um ponteiro para o endereço de uma string de mensagem de erro ASCII alocada pelo plug-in que pode ser retornado neste parâmetro se a execução da API db2secGroupPluginInit não for bem-sucedida.
mensagem de erro
Saída. Um ponteiro para um inteiro que indica o comprimento em bytes da string de mensagem de erro no parâmetro errormsg .