FaxDevInitialize-Funktion (faxdev.h)

Der Faxdienst ruft die FaxDevInitialize-Funktion jedes Mal auf, wenn der Dienst gestartet wird, nachdem er die FSP-DLL (Fax Service Provider) geladen hat. Jeder FSP muss die FaxDevInitialize-Funktion exportieren.

Syntax

BOOL FaxDevInitialize(
  [in]  HLINEAPP              LineAppHandle,
  [in]  HANDLE                HeapHandle,
  [out] PFAX_LINECALLBACK     *LineCallbackFunction,
  [in]  PFAX_SERVICE_CALLBACK FaxServiceCallback
);

Parameter

[in] LineAppHandle

Typ: HLINEAPP

Gibt ein Handle für die Registrierung des Faxdiensts bei TAPI an. Weitere Informationen finden Sie in der TAPI 2.x lineInitializeEx-Funktion .

[in] HeapHandle

Typ: HANDLE

Gibt ein Handle für einen Heap an, den der FSP für alle Speicherzuordnungen verwenden muss.

[out] LineCallbackFunction

Typ: PFAX_LINECALLBACK*

Zeiger auf eine Variable, die einen Zeiger auf eine TAPI-Zeilenrückruffunktion empfängt.

[in] FaxServiceCallback

Typ: PFAX_SERVICE_CALLBACK

Zeiger auf eine Dienstrückruffunktion. Obwohl diese Funktion derzeit nicht verwendet wird, wird erwartet, dass dieses Feature in einer zukünftigen Version des Faxdiensts verfügbar ist und Funktionen vom Faxdienst für den FSP bereitstellt.

Rückgabewert

Typ: BOOL

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ein Nichtzero-Wert.

Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null. In diesem Fall verwendet der aktuelle instance des Faxdiensts diesen FSP nicht. Alle Geräte, die von diesem FSP unterstützt werden, können keine Faxe senden oder empfangen. Um erweiterte Fehlerinformationen abzurufen, ruft der Faxdienst GetLastError auf.

Hinweise

Der FSP muss auf die FaxDevInitialize-Funktion reagieren, indem er die erforderliche Initialisierung ausführt.

Der FSP muss die FaxLineCallback-Funktion bereitstellen, die durch den Parameter LineCallbackFunction angegeben wird. Der Faxdienst ruft diese Funktion auf, wenn er ein TAPI-Ereignis an den FSP übermitteln muss.

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

Faxdienstanbieterfunktionen

FaxDevStartJob

FaxDevVirtualDeviceCreation

FaxLineCallback

Verwenden der Faxdienstanbieter-API

lineInitializeEx