Istatus

IStatus

L’interface IStatus remplace ISC_STATUS_ARRAY. La fonctionnalité a été étendue : l’état a un accès séparé aux vecteurs d’erreur et d’avertissement, peut contenir des vecteurs de longueur illimitée, stocke indépendamment les chaînes utilisées dans les vecteurs et n’a pas besoin d’un tampon de chaînes de caractères. Dans C++, IStatus est toujours utilisé dans le wrapper d’état, l’API C++ fournit deux wrappers différents qui ont un comportement différent lorsqu’une erreur est renvoyée par un appel d’API. L’interface a été réduite au minimum (des méthodes telles que la conversion en ext ont été déplacées vers l’interface IUtil pour la rendre plus facile à implémenter par les utilisateurs en cas de besoin.

init
```
void init()
```
Nettoie l’interface et la réinitialise à son état d’origine.
getState
```
unsigned getState()
```
Renvoie l’état actuel de l’interface, les flags retournés peuvent être combinés avec OR.
setErrors2
```
void setErrors2(unsigned length, const intptr_t* value)
```
Définit le contenu du vecteur d’erreur avec la longueur explicitement spécifiée dans l’appel.
setWarnings2
```
void setWarnings2(unsigned length, const intptr_t* value)
```
Définit le contenu du vecteur d’alerte avec la longueur explicitement spécifiée dans l’appel.
setErrors
```
void setErrors(const intptr_t* value)
```
définit le contenu du vecteur d’erreur, la longueur est déterminée par le contexte de valeur.
setWarnings
```
void setWarnings(const intptr_t* value)
```
définit le contenu du vecteur d’alerte, la longueur est déterminée par le contexte de valeur.
getErrors
```
const intptr_t* getErrors()
```
Renvoie un vecteur d’erreur.
getWarnings
```
const intptr_t* getWarnings()
```
Renvoie un vecteur d’alerte.
clone
```
IStatus* clone()
```
Crée un clone de l’interface courante.

Les constantes définies dans IStatus

Les flags renvoyés par l’attribut getState():

STATE_WARNINGS
STATE_ERRORS

Codes d’achèvement :

RESULT_ERROR
RESULT_OK
RESULT_NO_DATA
RESULT_SEGMENT

IBatchCompletionState

IBatchCompletionState — Une interface à usage unique, toujours retournée par la méthode execute() de l’interface IBatch.Il contient plus ou moins (en fonction des paramètres passés lors de la création de l’IBatch) des informations détaillées sur les résultats de l’exécution du lot.

getSize
```
unsigned getSize(StatusType* status)
```
Renvoie le nombre total de messages traités.
getState
```
int getState(StatusType* status, unsigned pos)
```
Renvoie le résultat d’un message avec le numéro pos. Pour toute erreur avec le message, il s’agit d’une constante EXECUTE_FAILED, la valeur de retour en cas de succès dépend de la présence du paramètre RECORD_COUNTS lors de la création du paquet.Lorsqu’elle est présente et qu’elle a une valeur différente de zéro, le nombre d’enregistrements insérés, mis à jour ou supprimés lors du traitement d’un message particulier est renvoyé, sinon la constante SUCCESS_NO_INFO est renvoyée.
findError
```
unsigned findError(StatusType* status, unsigned pos)
```
Recherche le message suivant (commençant par pos) à l’origine de l’erreur.En l’absence d’un tel message, la constante NO_MORE_ERRORS est renvoyée. Le nombre de vecteurs d’état renvoyés dans cette interface est limité par la valeur du paramètre DETAILED_ERRORS lors de la création du package.
getStatus
```
void getStatus(StatusType* status, IStatus* to, unsigned pos)
```
Renvoie des informations détaillées (vecteur d’état complet) sur l’erreur qui s’est produite lors du traitement du message pos.Pour faire la distinction entre les erreurs (dans IBatch::execute() ou dans IBatchCompletionState::getStatus()), cet état est renvoyé dans un paramètre to séparé, par opposition aux erreurs dans cet appel, qui sont placées dans le paramètre status.

Valeurs spéciales renvoyées par getState() :

EXECUTE_FAILED — Une erreur s’est produite lors du traitement de ce message.
SUCCESS_NO_INFO — Aucune information sur la mise à jour des dossiers n’a été recueillie.

La valeur spéciale renvoyée par findError() est :

NO_MORE_ERRORS – Il n’y a plus de messages d’erreur dans ce package.