FAX_RECEIVE struttura (faxdev.h)

La struttura FAX_RECEIVE contiene informazioni su un documento fax in ingresso. Queste informazioni includono il nome del file che riceverà il flusso di dati fax e il nome e il numero di telefono del dispositivo di ricezione.

Sintassi

typedef struct _FAX_RECEIVE {
  DWORD  SizeOfStruct;
  LPWSTR FileName;
  LPWSTR ReceiverName;
  LPWSTR ReceiverNumber;
  DWORD  Reserved[4];
} FAX_RECEIVE, *PFAX_RECEIVE;

Members

SizeOfStruct

Tipo: DWORD

Specifica le dimensioni, in byte, della struttura FAX_RECEIVE . Prima di chiamare la funzione FaxDevReceive , il servizio fax imposta questo membro su sizeof(FAX_RECEIVE). Per ulteriori informazioni, vedere la sezione Osservazioni successiva.

FileName

Tipo: LPWSTR

Puntatore a una stringa di caratteri Unicode con terminazione null che specifica il percorso completo del file in cui la FSP deve archiviare il flusso di dati di un documento fax in ingresso. Il flusso di dati è un file di classe TIFF F. Per altre informazioni, vedere Formato immagine fax. Il servizio fax crea il file prima di chiamare la funzione FaxDevReceive . La FSP deve specificare il flag di OPEN_EXISTING quando si apre questo file.

ReceiverName

Tipo: LPWSTR

Puntatore a una stringa di caratteri Unicode con terminazione null che specifica il nome del dispositivo di ricezione. La FSP invierà il nome al dispositivo di invio remoto dopo che il dispositivo di ricezione riceve un fax in ingresso. Per ulteriori informazioni, vedere la sezione Osservazioni successiva.

ReceiverNumber

Tipo: LPWSTR

Puntatore a una stringa di caratteri Unicode con terminazione null che specifica il numero di telefono del dispositivo di ricezione. La FSP invierà il numero al dispositivo di invio remoto dopo che il dispositivo di ricezione riceve un fax in ingresso. Per ulteriori informazioni, vedere la sezione Osservazioni successiva.

Reserved[4]

Tipo: DWORD

Questo membro è riservato per l'uso futuro da Parte di Microsoft. Deve essere impostato su zero.

Commenti

La FSP deve impostare i membri ReceiverName e ReceiverNumber in questa struttura. Il servizio fax alloca la memoria per queste stringhe. La dimensione della memoria allocata dal servizio è uguale a sizeof(FAX_RECEIVE) + FAXDEVRECEIVE_SIZE. La FSP deve inserire le stringhe nel blocco di memoria che segue la struttura FAX_RECEIVE . Si noti che è necessario consentire la dimensione della stringa FileName che segue immediatamente dopo la struttura FAX_RECEIVE . I membri ReceiverName e ReceiverNumber devono puntare alla posizione delle stringhe nel blocco di memoria.

L'esempio di codice e il diagramma seguenti illustrano come compilare la memoria allocata dal servizio fax.

PWSTR ReceiverName;
PWSTR ReceiverNumber;

//
// Routine to retrieve the receiver name
//   and receiver number here.

//
// Set the receiver name and receiver number data
//  in the FAX_RECEIVE structure; then
//  copy the data to the appropriate offset.
//
FaxReceive->ReceiverNumber = (LPWSTR) ( (LPBYTE)FaxReceive->FileName + sizeof(WCHAR)*(wcslen(FaxReceive->FileName) + 1));
wcscpy_s(  FaxReceive->ReceiverNumber, ReceiverNumber );

FaxReceive->ReceiverName = (LPWSTR) ( (LPBYTE)FaxReceive->ReceiverNumber+ sizeof(WCHAR)*(wcslen(FaxReceive->ReceiverNumber) + 1));
wcscpy_s(  FaxReceive->ReceiverName, ReceiverName );

La FSP può riformatare i membri ReceiverName e ReceiverNumber e trasmettere i dati riformattati al dispositivo di invio remoto come identificatore del sottoscrittore (CSI) per rispettare la raccomandazione del corpo standard dell'International Telecomon Union (ITU) del Gruppo di studio 8 (SG8). Per altre informazioni, vedere i membri RoutingInfo e CSI della struttura FAX_DEV_STATUS .

Requisiti

Client minimo supportato	Windows 2000 Professional, Windows XP [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Intestazione	faxdev.h

Vedi anche

FAX_DEV_STATUS

Strutture del provider di servizi fax

FaxDevReceive

Uso dell'API Provider di servizi fax