FaxDevSend-Funktion (faxdev.h)

Der Faxdienst ruft die FaxDevSend-Funktion auf, um einem Faxdienstanbieter (FSP) zu signalisieren, dass er eine ausgehende Faxübertragung initiieren muss. Jeder FSP muss die FaxDevSend-Funktion exportieren.

Syntax

BOOL FaxDevSend(
  [in] HANDLE             FaxHandle,
  [in] PFAX_SEND          FaxSend,
       PFAX_SEND_CALLBACK FaxSendCallback
);

Parameter

[in] FaxHandle

Typ: HANDLE

Gibt ein Faxhandle an, das von der FaxDevStartJob-Funktion zurückgegeben wird.

[in] FaxSend

Typ: PFAX_SEND

Zeiger auf eine FAX_SEND Struktur, die die sendenden Informationen enthält. Weitere Informationen finden Sie im folgenden Abschnitt "Hinweise".

FaxSendCallback

Typ: PFAX_SEND_CALLBACK

Zeiger auf eine Rückruffunktion, die den Faxdienst über das Anrufhandle benachrichtigt, das TAPI zuweist. Weitere Informationen finden Sie im folgenden Abschnitt "Hinweise".

Rückgabewert

Typ: BOOL

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null.

Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null. Um erweiterte Fehlerinformationen zu erhalten, ruft der Faxdienst GetLastError auf.

Hinweis Für eine erfolgreiche Übermittlung sollte FaxDevSend() TRUE und FaxDevReportStatus() FS_COMPLETED zurückgeben. Bei einem nicht erfolgreichen Senden sollte FaxDevSend() FALSE zurückgeben, und FaxDevReportStatus() sollte einen der folgenden Codes zurückgeben: FS_LINE_UNAVAILABLE, FS_NO_ANSWER, FS_NO_DIAL_TONE, FS_DISCONNECTED, FS_BUSY, FS_NOT_FAX_CALL oder FS_FATAL_ERROR. Wenn nach einem fehlgeschlagenen Fax das Fax nicht erneut gesendet werden soll, sollte FaxDevReportStatus() einen anderen Code als die hier aufgeführten zurückgeben.

 

Hinweise

Der FSP muss auf die FaxDevSend-Funktion reagieren, indem er den Aufruf sendet, die Daten sendet und den Aufruf beendet. Der Anbieter kann die lineSetMediaMode-Funktion aufrufen, um den Medienmodus des Aufrufs ordnungsgemäß festzulegen. Der Faxdienstanbieter muss die vom ReceiverNumber-Member der FAX_SEND-Struktur angegebene Nummer wählen.

Der FSP besitzt den Besitz der Zeile im Kontext der FaxDevSend-Funktion und muss alle Protokoll- und Fehlerkorrekturen verarbeiten.

Der Datenstrom, der in der Datei gespeichert ist, die vom FileName-Element der FAX_SEND-Struktur angegeben wird, ist eine Tagged Image File Format Class F (TIFF Class F)-Datei. Weitere Informationen finden Sie unter Faxbildformat.

Um den Faxdienst darüber zu benachrichtigen, dass ein Anruf eingerichtet wurde, muss der FSP die FaxSendCallback-Funktion aufrufen, auf die der FaxSendCallback-Parameter verweist. Die Rückruffunktion stellt dem Faxdienst auch das Anrufhandle bereit, das TAPI zuweist. Dieses Handle ist für das ROUTING von TAPI-Nachrichten erforderlich. Wenn der FSP FaxSendCallback nicht aufruft, fehlen alle anrufspezifischen Ereignisse für den Sendevorgang.

Anforderungen

Unterstützte Mindestversion (Client)	Windows 2000 Professional, Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	faxdev.h

Weitere Informationen

FAX_SEND

Faxdienstanbieterfunktionen

FaxDevReceive

FaxDevStartJob

FaxSendCallback

Verwenden der Faxdienstanbieter-API