IFaxTiff-Schnittstelle (faxcom.h)

Die duale IFaxTiff-Schnittstelle wird von einer Faxclientanwendung verwendet, um Informationen zu FaxTiff-Objekten abzurufen. Ein FaxTiff-Objekt stellt eine Tagged Image File Format Class F (TIFF Class F)-Datei dar, die vom Faxdienst übertragen oder empfangen wurde. Der Faxdienst bettet benutzerdefinierte TIFF-Tags (Tagged Image File Format) in die Datei ein, um Informationen zur Faxübertragung zu speichern.

Es ist nicht erforderlich, mit der Struktur einer TIFF-Datei vertraut zu sein, um die IFaxTiff-Schnittstelle zu verwenden und auf die Attribute von FaxTiff-Objekten zuzugreifen. Diese Schnittstelle bietet eine praktische Alternative zum manuellen Analysieren der TIFF-Daten in einer Faxdatei. Die IFaxTiff-Schnittstelle umfasst die folgenden Eigenschaftenmethoden:

  • Eigenschaftenmethoden zum Festlegen und Abrufen des Namens der Faxdatei, die vom FaxTiff-Objekt beschrieben wird.
  • Eigenschaftenmethoden zum Abrufen anderer Attribute des FaxTiff-Objekts , z. B. Geräte- und Stationsbezeichner, die Faxnummer sowie Absender- und Empfängernamen.
Hinweis Eine Faxclientanwendung muss die Image-Eigenschaft festlegen, bevor eine andere Eigenschaft für ein FaxTiff-Objekt abgerufen wird.
 

Vererbung

Die IFaxTiff-Schnittstelle erbt von der IDispatch-Schnittstelle.

Methoden

Die IFaxTiff-Schnittstelle verfügt über diese Methoden.

 
IFaxTiff::get_CallerId

Ruft die CallerId-Eigenschaft für ein FaxTiff-Objekt ab. Die CallerId-Eigenschaft ist eine Zeichenfolge, die das aufrufende Gerät identifiziert, das eine angegebene Faxdatei gesendet hat.
IFaxTiff::get_Csid

Ruft die Csid-Eigenschaft für ein FaxTiff-Objekt ab. Die Csid-Eigenschaft ist eine Zeichenfolge, die CSID-Informationen (Station Identifier) enthält, die in der Regel die Faxnummer des Geräts ist, das die angegebene Faxdatei empfangen hat.
IFaxTiff::get_Image

Legt die Image-Eigenschaft für ein FaxTiff-Objekt fest oder ruft sie ab. (Abrufen)
IFaxTiff::get_RawReceiveTime

Ruft die RawReceiveTime-Eigenschaft für ein FaxTiff-Objekt ab.
IFaxTiff::get_ReceiveTime

Ruft die ReceiveTime-Eigenschaft für ein FaxTiff-Objekt ab.
IFaxTiff::get_RecipientName

Ruft die RecipientName-Eigenschaft für ein FaxTiff-Objekt ab. Die RecipientName-Eigenschaft ist eine NULL-Zeichenfolge, die den Namen des Empfängers für die angegebene Faxdatei enthält.
IFaxTiff::get_RecipientNumber

Ruft die RecipientNumber-Eigenschaft für ein FaxTiff-Objekt ab. Die RecipientNumber-Eigenschaft ist eine null-beendete Zeichenfolge, die die Faxnummer enthält, an die ein Fax übertragen wurde.
IFaxTiff::get_Routing

Ruft die Routing-Eigenschaft für ein FaxTiff-Objekt ab. Die Routing-Eigenschaft ist eine NULL-beendete Zeichenfolge, die die eingehende Routingzeichenfolge für eine angegebene Faxdatei enthält.
IFaxTiff::get_SenderName

Ruft die SenderName-Eigenschaft für ein FaxTiff-Objekt ab. Die SenderName-Eigenschaft ist eine NULL-Zeichenfolge, die den Namen des Benutzers enthält, der die Faxübertragung in die Warteschlange gestellt hat.
IFaxTiff::get_TiffTagString

Ruft die TiffTagString-Eigenschaft für ein FaxTiff-Objekt ab. Die TiffTagString-Eigenschaft ist eine NULL-Zeichenfolge, die den Wert eines angegebenen TIFF-Tags (TIFF) (TIFF) (Feld) enthält.
IFaxTiff::get_Tsid

Ruft die Tsid-Eigenschaft für ein FaxTiff-Objekt ab. Die Tsid-Eigenschaft ist eine null-terminierte Zeichenfolge, die TSID-Informationen (Transmission Station Identifier) enthält, die in der Regel die Faxnummer des Geräts ist, das die angegebene Faxdatei gesendet hat.
IFaxTiff::p ut_Image

Legt die Image-Eigenschaft für ein FaxTiff-Objekt fest oder ruft sie ab. (Put)

Bemerkungen

Wann muss implementiert werden?

Sie sollten diese Schnittstelle nicht implementieren. Die Microsoft-Standardimplementierung bietet vollständige Funktionalität.

Wann sollte verwendet werden?

Verwenden Sie die IFaxTiff-Schnittstelle , um die Eigenschaften eines FaxTiff-Objekts abzurufen.

Rufen Sie die CoCreateInstance-Funktion auf, um einen Zeiger auf eine IFaxTiff-Schnittstelle abzurufen und eine Instanz eines FaxTiff-Objekts zu erstellen. Es ist nicht erforderlich, die IFaxServer::Connect-Methode aufzurufen, um eine Verbindung mit einem aktiven Faxserver zu initiieren. Für den Zugriff auf die IFaxTiff-Schnittstelle ist keine Faxserververbindung erforderlich.

Die Eigenschaftenmethoden der IFaxTiff-Schnittstelle rufen die im Folgenden beschriebenen Eigenschaften ab oder legen sie fest. Wenn die -Eigenschaft lesezugriff unterstützt, enthält die IFaxTiff-Schnittstelle eine get_PropertyName-Methode . Wenn die -Eigenschaft schreibzugriff unterstützt, enthält die Schnittstelle eine put_PropertyName-Methode .

Im Folgenden sind die Eigenschaften aufgeführt, die einem FaxTiff-Objekt zugeordnet sind.

Anforderungen

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

Weitere Informationen

Faxdienst-Client-API-Schnittstellen

Faxdienstclient-API für Windows 2000

IDispatch