COPY_TRACE_TO_FILE
Il verbo COPY_TRACE_TO_FILE concatena i singoli file di traccia del servizio API/collegamento per formare un singolo file.
La struttura seguente descrive il blocco di controllo verbo (VCB) usato dal verbo COPY_TRACE_TO_FILE verbo.
Sintassi
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];
};
Members
Opcode
Parametro fornito. Verbo che identifica il codice dell'operazione, SV_COPY_TRACE_TO_FILE.
opext
Campo riservato.
reserv2
Campo riservato.
Primary_rc
Parametro restituito. Specifica il codice restituito primario impostato da APPC al completamento del verbo. I codici restituiti validi variano a seconda del verbo APPC rilasciato. Per questo verbo, vedere Codici restituiti per i codici di errore validi.
Secondary_rc
Parametro restituito. Specifica il codice restituito secondario impostato da APPC al completamento del verbo. I codici restituiti validi variano a seconda del verbo APPC rilasciato. Per questo verbo, vedere Codici restituiti per i codici di errore validi.
reserv3
Campo riservato.
file_name
Parametro fornito. Specifica il nome del file in cui copiare i dati di traccia. Questo parametro è una stringa di caratteri a 64 byte e può includere un percorso. Se il nome è minore di 64 byte, usare spazi per riquadrirlo a destra.
file_option
Parametro fornito. Specifica l'opzione di copia file di output:
Usare SV_NEW per copiare la traccia solo se il file specificato non esiste già.
Usare SV_OVERWRITE per copiare la traccia in un file esistente sovrascrivendo i dati correnti. Se necessario, le dimensioni del file sono aumentate; e il file viene creato se non esiste già.
reserv4
Indirizzo in cui risiedono i dati forniti.
Codici restituiti
SV_OK
Codice restituito primario; il verbo eseguito correttamente.
SV_PARAMETER_CHECK
Codice restituito primario; il verbo non è stato eseguito a causa di un errore di parametro.
SV_INVALID_FILE_OPTION
Codice restituito secondario; è stato specificato un valore diverso da SV_NEW o SV_OVERWRITE per file_option.
SV_STATE_CHECK
Codice restituito primario; il verbo non è stato eseguito perché è stato rilasciato in uno stato non valido.
SV_COPY_TRACE_IN_PROGRESS
Codice restituito secondario; un verbo COPY_TRACE_TO_FILE rilasciato in precedenza è ancora in corso.
SV_TRACE_FILE_EMPTY
Codice restituito secondario; non sono presenti dati nei file di traccia.
SV_TRACE_NOT_STOPPED
Codice restituito secondario; una traccia era in corso quando il verbo è stato rilasciato.
SV_COMM_SUBSYSTEM_NOT_LOADED
Codice restituito primario; Impossibile caricare o terminare un componente obbligatorio durante l'elaborazione del verbo. Pertanto, la comunicazione non poteva essere eseguita. Contattare l'amministratore di sistema per un'azione correttiva.
SV_FILE_ALREADY_EXISTS
Codice restituito primario; quando è stata usata l'opzione file SV_NEW, il nome del file specificato era il nome di un file esistente.
SV_INVALID_VERB
Codice restituito primario; il parametro opcode non corrisponde al codice dell'operazione di alcun verbo. Nessun verbo eseguito.
SV_INVALID_VERB_SEGMENT
Codice restituito primario; VCB esteso oltre la fine del segmento di dati.
SV_OUTPUT_DEVICE_FULL
Codice restituito primario; nel dispositivo in cui risiede il file di output non è sufficiente. Riprovare l'operazione dopo aver liberato spazio su disco aggiuntivo.
SV_UNEXPECTED_DOS_ERROR
Codice restituito primario; si è verificata una delle seguenti condizioni:
Il sistema Microsoft Windows ha rilevato un errore durante l'elaborazione del verbo. Il codice restituito dal sistema operativo è stato restituito tramite il codice restituito secondario. Se il problema persiste, contattare l'amministratore di sistema per un'azione correttiva.
Un file CSV è stato rilasciato da un ciclo di messaggi richiamato da un'altra applicazione che emette una chiamata alla funzione SendMessage di Windows anziché dalla chiamata di funzione Windows PostMessage più comune. L'elaborazione verbo non può essere eseguita.
Un file CSV è stato rilasciato quando SendMessage ha richiamato l'applicazione. È possibile determinare se l'applicazione è stata richiamata con SendMessage usando la chiamata di funzione API Windows InSendMessage .
Commenti
Esistono due file di traccia API/link-service. I file vengono usati in alternativa; traccia passa da un file all'altro quando un file è pieno (maggiore di 250K). Quando viene chiamato COPY_TRACE_TO_FILE , questi file di traccia vengono concatenati e copiati in un singolo file, il nome di cui viene specificato come parametro per la chiamata.
La traccia del servizio API/collegamento viene arrestata prima di emettere il verbo e riavviata dopo il completamento della copia. I file di traccia vengono reimpostati al termine del verbo.