COPY_TRACE_TO_FILE

  • Article

Le verbe COPY_TRACE_TO_FILE concatène les fichiers de suivi des services d’API/de liaison individuels pour former un fichier unique.

La structure suivante décrit le bloc de contrôle de verbe (VCB) utilisé par le verbe COPY_TRACE_TO_FILE.

Syntaxe


struct copy_trace_to_file {  
    unsigned short       opcode;  
    unsigned char        opext;  
    unsigned char        reserv2;  
    unsigned short       primary_rc;  
    unsigned long        secondary_rc;  
    unsigned char        reserv3[8];  
    unsigned char        file_name[64];  
    unsigned char        file_option;  
    unsigned char        reserv4[12];  
};

Membres

opcode
Paramètre fourni. Le verbe identifiant le code d’opération, SV_COPY_TRACE_TO_FILE.

opext
Un champ réservé.

reserv2
Champ réservé.

primary_rc
Paramètre retourné. Spécifie le code de retour principal défini par APPC à l’achèvement du verbe. Les codes de retour valides dépendent du verbe APPC émis. Pour connaître les codes d’erreur valides de ce verbe, consultez Codes de retour.

secondary_rc
Paramètre retourné. Spécifie le code de retour secondaire défini par APPC à l’achèvement du verbe. Les codes de retour valides dépendent du verbe APPC émis. Consultez la section Codes de retour pour connaître les codes d’erreur valides pour ce verbe.

reserv3
Un champ réservé.

file_name
Paramètre fourni. Spécifie le nom du fichier dans lequel les données de suivi doivent être copiées. Ce paramètre est une chaîne de caractères de 64 octets et peut inclure un chemin d’accès. Si le nom est inférieur à 64 octets, utilisez des espaces pour le remplir à droite.

file_option
Paramètre fourni. Spécifie l’option de copie du fichier de sortie :

  • Utilisez SV_NEW pour copier le suivi uniquement si le fichier spécifié n’existe pas déjà.

  • Utilisez SV_OVERWRITE pour copier le suivi dans un fichier existant, en remplaçant les données actuelles. La taille du fichier augmente si nécessaire ; le fichier est créé s’il n’existe pas déjà.

reserv4
Adresse où résident les données fournies.

Codes de retour

SV_OK
Code de retour principal ; le verbe s’est exécuté correctement.

SV_PARAMETER_CHECK
Code de retour principal ; le verbe n’a pas été exécuté en raison d’une erreur de paramètre.

SV_INVALID_FILE_OPTION
Code de retour secondaire ; une valeur autre que SV_NEW ou SV_OVERWRITE a été spécifiée pour file_option.

SV_STATE_CHECK
Code de retour principal ; le verbe n’a pas été exécuté, car il a été émis dans un état non valide.

SV_COPY_TRACE_IN_PROGRESS
Code de retour secondaire ; un verbe COPY_TRACE_TO_FILE précédemment émis est toujours en cours.

SV_TRACE_FILE_EMPTY
Code de retour secondaire ; il n’y a aucune donnée dans les fichiers de suivi.

SV_TRACE_NOT_STOPPED
Code de retour secondaire ; un suivi était en cours lors de l’émission du verbe.

SV_COMM_SUBSYSTEM_NOT_LOADED
Code de retour principal ; un composant requis n’a pas pu être chargé ou arrêté lors du traitement du verbe. Par conséquent, la communication n’a pas pu être établie. Contactez l’administrateur système pour résoudre le problème.

SV_FILE_ALREADY_EXISTS
Code de retour principal ; lorsque l’option de fichier SV_NEW a été utilisée, le nom de fichier spécifié était le nom d’un fichier existant.

SV_INVALID_VERB
Code de retour principal ; le paramètre opcode ne correspondait pas au code d’opération d’un verbe. Aucun verbe n’est exécuté.

SV_INVALID_VERB_SEGMENT
Code de retour principal : le VCB s’étend au-delà de la fin du segment de données.

SV_OUTPUT_DEVICE_FULL
Code de retour principal ; l’espace est insuffisant sur l’appareil sur lequel se trouve le fichier de sortie. Retentez l’opération après avoir libéré de l’espace disque supplémentaire.

SV_UNEXPECTED_DOS_ERROR
Code de retour principal ; l’une des conditions suivantes s’est produite :

  • Le système Microsoft Windows a rencontré une erreur lors du traitement du verbe. Le code de retour du système d’exploitation a été retourné via le code de retour secondaire. Si le problème persiste, contactez l’administrateur système pour résoudre le problème.

  • Un fichier CSV a été émis à partir d’une boucle de message appelée par une autre application émettant un appel de fonction Windows SendMessage, plutôt que l’appel de fonction Windows PostMessage le plus courant. Le traitement du verbe ne peut pas avoir lieu.

  • Un fichier CSV a été émis lorsque SendMessage a appelé votre application. Vous pouvez déterminer si votre application a été appelée avec SendMessage à l’aide de l’appel de fonction API Windows InSendMessage.

Notes

Il existe deux fichiers de suivi d’API/de service de liaison. Les fichiers sont également utilisés ; le suivi passe d’un fichier à l’autre lorsqu’un fichier est plein (plus de 250 000). Lorsque COPY_TRACE_TO_FILE est appelée, ces fichiers de suivi sont concaténés et copiés dans un fichier unique, dont le nom est spécifié en tant que paramètre de l’appel.

Le suivi du service API/de liaison est arrêté avant d’émettre le verbe, puis redémarré une fois la copie terminée. Les fichiers de suivi sont réinitialisés lorsque ce verbe est correctement utilisé.