Partager via

COPY_TRACE_TO_FILE

Le verbe COPY_TRACE_TO_FILE concatène des fichiers de trace d’API/liaison individuels pour former un seul fichier.

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. Verbe identifiant le code d’opération, SV_COPY_TRACE_TO_FILE.

opext
Champ réservé.

réserver2
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 varient en fonction du verbe APPC émis. Consultez les codes de retour pour obtenir des codes d’erreur valides pour ce verbe.

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 varient en fonction du verbe APPC émis. Consultez les codes de retour pour obtenir des codes d’erreur valides pour ce verbe.

réserver3
Champ réservé.

file_name
Paramètre fourni. Spécifie le nom du fichier dans lequel les données de trace 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 de fichier de sortie :

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

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

réserver4
Adresse à laquelle résident les données fournies.

Codes de retour

SV_OK
Code de retour principal ; le verbe exécuté avec succès.

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 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’existe aucune donnée dans les fichiers de trace.

SV_TRACE_NOT_STOPPED
Code de retour secondaire ; une trace était en cours lorsque le verbe a été émis.

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. Ainsi, la communication n’a pas pu avoir lieu. Contactez l’administrateur système pour obtenir une action corrective.

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 correspond pas au code d’opération d’un verbe. Aucun verbe 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 disponible sur l’appareil où réside le fichier de sortie est insuffisant. Réessayez 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 obtenir une action corrective.

  • Un csv a été émis à partir d’une boucle de message appelée par une autre application qui émet un appel de fonction Windows SendMessage , plutôt que l’appel de fonction Windows PostMessage plus courant. Le traitement des verbes ne peut pas avoir lieu.

  • Un 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 .

Remarques

Il existe deux fichiers de trace API/link-service. Les fichiers sont utilisés de manière alternative ; le suivi passe d’un fichier à l’autre lorsqu’un fichier est plein (supérieur à 250 Ko). Lorsque COPY_TRACE_TO_FILE est appelée, ces fichiers de trace sont concaténés et copiés dans un seul fichier, dont le nom est spécifié comme paramètre pour l’appel.

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

  • Last updated on