Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
La struttura FAX_DEV_STATUS contiene informazioni sullo stato e sull'identificazione relative a una singola operazione fax attiva.
Sintassi
typedef struct _FAX_DEV_STATUS {
DWORD SizeOfStruct;
DWORD StatusId;
DWORD StringId;
DWORD PageCount;
LPWSTR CSI;
LPWSTR CallerId;
LPWSTR RoutingInfo;
DWORD ErrorCode;
DWORD Reserved[3];
} FAX_DEV_STATUS, *PFAX_DEV_STATUS;
Members
SizeOfStruct
Tipo: DWORD
Specifica le dimensioni, in byte, della struttura FAX_DEV_STATUS . Prima di rispondere alla funzione FaxDevReportStatus , il FSP deve impostare questo membro su sizeof(FAX_DEV_STATUS).
StatusId
Tipo: DWORD
Specifica un valore o un codice di stato fax. Può trattarsi di un codice di stato fax predefinito (illustrato di seguito), uno dei codici di errore TAPI LINEERR_ Costanti o un valore definito dal FSP. Se l'identificatore di stato è definito dal provider, anche FSP deve fornire un valore per il membro StringId . Di seguito sono riportati i codici di stato predefiniti del fax.
| Valore | Significato |
|---|---|
| FS_INITIALIZING | La chiamata viene inizializzata. |
| FS_DIALING | Il FSP sta componendo cifre per la chiamata. |
| FS_TRANSMITTING | Il FSP trasmette il documento fax. |
| FS_RECEIVING | Il FSP riceve il documento fax. |
| FS_COMPLETED | La chiamata di trasmissione fax è completa. |
| FS_LINE_UNAVAILABLE | Il FSP non può completare la chiamata perché il dispositivo non è disponibile. |
| FS_BUSY | Il FSP ha ricevuto un segnale occupato. |
| FS_NO_ANSWER | Il FSP non può completare la chiamata perché il dispositivo ricevente non risponde. |
| FS_BAD_ADDRESS | Impossibile completare la chiamata perché l'indirizzo di destinazione non è valido. |
| FS_NO_DIAL_TONE | Il FSP non può completare la chiamata perché non rileva un tono di chiamata. |
| FS_DISCONNECTED | La chiamata è stata disconnessa dal dispositivo ricevente. |
| FS_FATAL_ERROR | Si è verificato un errore irreversibile. |
| FS_NOT_FAX_CALL | La chiamata è una chiamata dati o una chiamata vocale. |
| FS_CALL_DELAYED | Il FSP ha ricevuto un segnale occupato più volte. Il provider non può riprovare perché esistono restrizioni di composizione. Alcuni paesi/aree geografiche limitano il numero di tentativi quando un numero è occupato. |
| FS_USER_ABORT | La FSP ha annullato la trasmissione. L'annullamento può derivare da una chiamata alla funzione FaxDevAbortOperation . I provider di servizi di configurazione possono anche fornire un'interfaccia utente per l'annullamento delle trasmissioni fax. |
| FS_ANSWERED | Il FSP ha risposto alla chiamata in ingresso, ma non riceve ancora la chiamata. Questo stato indica al servizio fax che la chiamata potrebbe non essere una chiamata fax. |
| FS_CALL_BLACKLISTED | Il FSP non può completare la chiamata perché il numero di telefono è bloccato o riservato, ad esempio una chiamata a 911 o un altro numero di emergenza. |
I codici di stato del fax FS_BAD_ADDRESS, FS_CALL_BLACKLISTED e FS_USER_ABORT non provocheranno alcun tentativo. Il codice di stato del fax FS_LINE_UNAVAILABLE comporterà un tentativo immediato nel caso in cui la riga non sia disponibile perché il servizio ha perso la connessione al dispositivo (TAPI inviato LINE_CLOSE e il FSP segnalato FS_LINE_UNAVAILABLE). Il nuovo tentativo dipende dal fatto che il dispositivo venga rilevato online. Tutti gli altri codici di stato fax consentiranno al servizio fax di gestire i tentativi di ripetizione.
StringId
Tipo: DWORD
Specifica un identificatore di risorsa stringa per il membro StatusId se StatusId è definito dal provider. Il servizio fax carica la stringa dall'immagine FSP. Se StatusId contiene un codice di stato o un valore definito dal provider, questo membro è obbligatorio. Se StatusId contiene un codice di stato o un valore predefinito, questo membro viene ignorato.
PageCount
Tipo: DWORD
Specifica il numero della pagina nella trasmissione fax ricevuta dal FSP. Il numero di pagine è relativo a uno.
CSI
Tipo: LPWSTR
Puntatore a una stringa di caratteri Unicode con terminazione Null che specifica un identificatore del dispositivo fax remoto connesso alla chiamata corrente alla funzione FaxDevReceive o FaxDevSend .
Se l'operazione invia un fax, l'identificatore specifica il CSID del dispositivo remoto; se l'operazione riceve un fax, l'identificatore specifica l'identificatore TSID del dispositivo remoto.
CallerId
Tipo: LPWSTR
Puntatore a una stringa di caratteri Unicode con terminazione Null che identifica il dispositivo chiamante che ha inviato il documento fax ricevuto. Questa stringa può includere il numero di telefono del dispositivo chiamante.
RoutingInfo
Tipo: LPWSTR
Puntatore a una stringa di caratteri Unicode con terminazione Null che specifica la stringa di routing per un fax in ingresso. La stringa deve essere del formato:
Canonical-Phone-Number[|Additional-Routing-Info]
dove Canonical-Phone-Number è definito nell'argomento Indirizzo della documentazione TAPI (vedere la sottotitolo indirizzo canonico); ed Additional-Routing-Info è il subaddress di un indirizzo canonico e usa il formato subaddress.
Per il routing DID, aggiungere le cifre DID specifiche al prefisso del numero di telefono. L'indirizzo DID deve essere il numero di telefono canonico che corrisponde al numero di telefono completo che il mittente avrebbe composto.
Se sono presenti informazioni aggiuntive sul routing, ad esempio subaddressing o toni DTMF, separarlo dal numero di telefono canonico in base a un carattere barra verticale, come indicato nella specifica TAPI. È possibile specificare più destinatari.
Per altre informazioni, vedere le sottotitolo Indirizzo componibile e Indirizzo canonico nell'argomento Indirizzo della documentazione di TAPI.
ErrorCode
Tipo: DWORD
Specifica uno dei codici di errore di sistema Win32 [Base] che deve essere utilizzato dal FSP per segnalare un errore che si verifica. Il FSP deve impostare questo valore su NO_ERROR quando è in esecuzione e dopo che un processo fax viene completato normalmente.
Reserved[3]
Tipo: DWORD
Questo membro è riservato da Microsoft. Deve essere impostato su zero.
Commenti
Il FSP deve impostare tutti i membri della struttura FAX_DEV_STATUS sulle informazioni sullo stato per l'operazione fax attiva o impostarle su zero.
Il servizio fax alloca la memoria per le stringhe a cui puntano i membri CSI, CallerId e RoutingInfo . La dimensione della memoria allocata dal servizio è uguale a sizeof(FAX_DEV_STATUS) + FAXDEVREPORTSTATUS_SIZE. Il FSP deve inserire le stringhe nel blocco di memoria che segue immediatamente la struttura FAX_DEV_STATUS . I membri CSI, CallerId e RoutingInfo devono puntare alla posizione delle stringhe nel blocco di memoria.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows 2000 Professional, Windows XP [solo app desktop] |
| Server minimo supportato | Windows Server 2003 [solo app desktop] |
| Intestazione | faxdev.h |