Partager via

DEFINE_TRACE

Le verbe DEFINE_TRACE active ou désactive le suivi pour les API spécifiées et contrôle la quantité de suivi.

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

Syntaxe

  
struct define_trace {  
    unsigned short       opcode;  
    unsigned char        opext;  
    unsigned char        reserv2;  
    unsigned short       primary_rc;  
    unsigned long        secondary_rc;  
    unsigned char        reserv3[8];  
    unsigned char        dt_set;  
    unsigned char        appc;  
    unsigned char        reserv4;  
    unsigned char        srpi;  
    unsigned char        sdlc;  
    unsigned char        tkn_rng_dlc;  
    unsigned char        pcnet_dlc;  
    unsigned char        dft;  
    unsigned char        acdi;  
    unsigned char        reserv5;  
    unsigned char        ehllapi;  
    unsigned char        x25_api;  
    unsigned char        x25_dlc;  
    unsigned char        twinax;  
    unsigned char        reserv6;  
    unsigned char        lua_api;  
    unsigned char        etherand;  
    unsigned char        subsym;  
    unsigned char        reserv7[8];  
    unsigned char        reset_trc;  
    unsigned short       trunc;  
    unsigned short       strg_size;  
    unsigned char        reserv8;  
    unsigned char        phys_link[8];  
    unsigned char        reserv9[56];  
};

Membres

Opcode
Paramètre fourni. Verbe identifiant le code d’opération, SV_DEFINE_TRACE.

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é.

dt_set
Paramètre fourni. Définit l’état de trace.

  • Utilisez SV_ON pour activer le suivi d’une API particulière si le paramètre relatif à l’API (par exemple , appc ou comm_serv) est défini sur SV_CHANGE.
  • Utilisez SV_OFF pour désactiver le suivi d’une API particulière si le paramètre relatif à l’API est défini sur SV_CHANGE.

Appc
Paramètre fourni. Indique si le suivi d’APPC est souhaité.

  • Utilisez SV_CHANGE pour activer ou désactiver le suivi pour APPC, en fonction du paramètre dt_set .
  • Utilisez SV_IGNORE pour laisser le suivi dans son état actuel pour APPC.

Les valeurs autorisées activent ou désactivent le bit 0 ; les bits 1 à 7 sont réservés.

réserver4
Champ réservé.

srpi
Paramètre fourni. Indique si le suivi de SRPI est souhaité.

  • Utilisez SV_CHANGE pour activer ou désactiver le suivi pour APPC, en fonction du paramètre dt_set .
  • Utilisez SV_IGNORE pour laisser le suivi dans son état actuel pour APPC.

Sdlc
Champ réservé.

tkn_rng_dlc
Champ réservé.

pcnet_dlc
Champ réservé.

Dft
Champ réservé.

acdi
Champ réservé.

réserver5
Champ réservé.

comm_serv
Paramètre fourni. Indique si le suivi de COMM_SERV_API est souhaité.

  • Utilisez SV_CHANGE pour activer ou désactiver le suivi pour APPC, en fonction du paramètre dt_set .
  • Utilisez SV_IGNORE pour laisser le suivi dans son état actuel pour APPC.

ehllapi
Champ réservé.

x25_api
Champ réservé.

x25_dlc
Champ réservé.

twinax
Champ réservé.

réserver6
Champ réservé.

lua_api
Champ réservé.

etherand
Champ réservé.

subsym
Champ réservé.

réserver7
Champ réservé.

reset_trc
Paramètre fourni. Indique si le pointeur du fichier de trace doit être réinitialisé.

  • Utilisez SV_NO pour ne pas réinitialiser le pointeur du fichier de trace au début du fichier de trace. Les enregistrements de trace précédents ne sont pas remplacés.
  • Utilisez SV_YES pour réinitialiser le pointeur du fichier de trace au début du fichier de trace. Les enregistrements de trace précédents sont remplacés.

troncation
Paramètre fourni. Spécifie le nombre maximal d’octets pour chaque enregistrement de trace. Les octets excédentaires sont tronqués. Définissez cette valeur sur zéro si vous ne souhaitez pas de troncation.

strg_size
Champ réservé.

réserver8
Champ réservé.

phys_link
Champ réservé.

réserver9
Champ réservé.

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_RESET_TRACE
Code de retour secondaire ; le paramètre reset_trc contenait une valeur non valide.

SV_INVALID_SET
Code de retour secondaire ; le paramètre dt_set contenait une valeur non valide.

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 ; une COPY_TRACE_TO_FILE précédemment émise est toujours en cours. Les traces ne peuvent pas être actives lors de l’utilisation de DEFINE_TRACE.

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_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_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

Pour plus d’informations sur l’exécution et l’utilisation des traces, consultez le manuel approprié pour votre produit.

  • Last updated on