mit dieser Bibliothek kann man einen eigenen E-Mail-Client entwickeln und E-Mails per IMAP und POP3 herunterladen. SSL und TLS werden unterstützt.
Funktionen:
- OpenMailEx()
- Syntax:
Code: Alles auswählen
Result = OpenMailEx(ID, Protocol, MailServer$, Port, UserName$, Password$, SSL, ProtocolVersion, @ErrorOutput$)
- Beschreibung: Stellt eine Verbindung zum Mailserver her.
- Parameter:
- ID: Eine eindeutige Nummer. #PB_Any kann verwendet werden, um die Nummer automatisch zu generieren.
- Protocol: Eine der folgenden Protokolle kann verwendet werden:
- #PBEx_Mail_Protocol_IMAP
- #PBEx_Mail_Protocol_POP3: Hinweis: Bitte benutzen Sie dieses Protokoll derzeit nur für Testzwecken. Dieses Protokoll ist veraltet und wird nicht mehr weiterentwickelt.
- #PBEx_Mail_Protocol_SMTP: Nur gültig für SendMailEx() und SendMailFileEx().
- MailServer$: Die Adresse zum Mailserver
- Port: Port-Nummer
- UserName$: Benutzername oder E-Mail-Adresse für die Anmeldung.
- Password$: Passwort für die Anmeldung.
- SSL: Wenn 1, dann wird eine verschlüsselte Verbindung hergestellt.
- ProtocolVersion: Legt die Protokollversion für die verschlüsselte Verbindung fest. Folgende Konstanten können verwendet werden:
- #PBEx_Mail_ProtocolVersion_SSL30: SSL 3.0
- #PBEx_Mail_ProtocolVersion_TLS10: TLS 1.0
- #PBEx_Mail_ProtocolVersion_TLS11: TLS 1.1
- #PBEx_Mail_ProtocolVersion_TLS12: TLS 1.2
- #PBEx_Mail_ProtocolVersion_TLS13: TLS 1.3
- @ErrorOutput$: Falls ein Fehler auftrat, dann wird die Fehlermeldung in die Variable gespeichert. Diese Variable muss vor dem Übergeben mit 128 Zeichen reserviert werden. Maximale Länge der Rückgabe beträgt 128 Zeichen einschließlich des NULL-Zeichens. Wenn bei einem Fehler keine Fehlerbeschreibung zurückgegeben werden soll, dann kann stattdessen 0 übergeben werden.
- Rückgabewert:
- 1: Der Vorgang war erfolgreich. Falls #PB_Any verwendet wird, dann wird die ID zurückgegeben.
- Beispielcode:
Code: Alles auswählen
EnableExplicit Global PBEx_Mail #PBEx_Mail_Version$ = "1.1.6.0" #PBEx_Mail_Protocol_IMAP = 0 #PBEx_Mail_Protocol_POP3 = 1 #PBEx_Mail_Protocol_SMTP = 2 #PBEx_Mail_ProtocolVersion_SSL30 = 0 #PBEx_Mail_ProtocolVersion_TLS10 = 1 #PBEx_Mail_ProtocolVersion_TLS11 = 2 #PBEx_Mail_ProtocolVersion_TLS12 = 3 #PBEx_Mail_ProtocolVersion_TLS13 = 4 #PBEx_Mail_Priority_Normal = 0 #PBEx_Mail_Priority_Low = 1 #PBEx_Mail_Priority_High = 2 #PBEx_Mail_Event_NewMail = 0 #PBEx_Mail_Attribute_Unseen = 0 #PBEx_Mail_Attribute_Seen = 32 #PBEx_Mail_SeenType_AllMails = 0 #PBEx_Mail_SeenType_OnlySeenMails = 1 #PBEx_Mail_SeenType_OnlyUnseenMails = 2 #PBEx_Mail_FetchType_AllData = 0 #PBEx_Mail_FetchType_OnlyHeaderData = 1 CompilerIf #PB_Compiler_Processor = #PB_Processor_x86 PBEx_Mail = OpenLibrary(#PB_Any, "PB.Ex_Mail_x86.dll") CompilerElseIf #PB_Compiler_Processor = #PB_Processor_x64 PBEx_Mail = OpenLibrary(#PB_Any, "PB.Ex_Mail_x64.dll") CompilerEndIf If PBEx_Mail Prototype OpenMailEx(ID, Protocol, MailServer.p-Unicode, Port, UserName.p-Unicode, Password.p-Unicode, SSL, ProtocolVersion, ErrorOutput) Global OpenMailEx.OpenMailEx = GetFunction(PBEx_Mail, "OpenMailEx") Prototype CloseMailEx(ID, ErrorOutput) Global CloseMailEx.CloseMailEx = GetFunction(PBEx_Mail, "CloseMailEx") Prototype ExamineMailDirectoryEx(ID, ErrorOutput) Global ExamineMailDirectoryEx.ExamineMailDirectoryEx = GetFunction(PBEx_Mail, "ExamineMailDirectoryEx") Prototype MailDirectoryEntryNameEx(ID, Output, ErrorOutput) Global MailDirectoryEntryNameEx.MailDirectoryEntryNameEx = GetFunction(PBEx_Mail, "MailDirectoryEntryNameEx") Prototype ExamineMailEx(ID, SeenType, FetchType, SortByNew, ErrorOutput) Global ExamineMailEx.ExamineMailEx = GetFunction(PBEx_Mail, "ExamineMailEx") Prototype MailEntrySubjectEx(ID, Output, ErrorOutput) Global MailEntrySubjectEx.MailEntrySubjectEx = GetFunction(PBEx_Mail, "MailEntrySubjectEx") Prototype MailEntryBodyEx(ID, Output, ErrorOutput) Global MailEntryBodyEx.MailEntryBodyEx = GetFunction(PBEx_Mail, "MailEntryBodyEx") Prototype MailEntryFromEx(ID, Output, ErrorOutput) Global MailEntryFromEx.MailEntryFromEx = GetFunction(PBEx_Mail, "MailEntryFromEx") Prototype MailEntryToEx(ID, Output, ErrorOutput) Global MailEntryToEx.MailEntryToEx = GetFunction(PBEx_Mail, "MailEntryToEx") Prototype MailEntryCCEx(ID, Output, ErrorOutput) Global MailEntryCCEx.MailEntryCCEx = GetFunction(PBEx_Mail, "MailEntryCCEx") Prototype MailEntryBCCEx(ID, Output, ErrorOutput) Global MailEntryBCCEx.MailEntryBCCEx = GetFunction(PBEx_Mail, "MailEntryBCCEx") Prototype MailEntryDateEx(ID, ErrorOutput) Global MailEntryDateEx.MailEntryDateEx = GetFunction(PBEx_Mail, "MailEntryDateEx") Prototype MailEntryPriorityEx(ID, ErrorOutput) Global MailEntryPriorityEx.MailEntryPriorityEx = GetFunction(PBEx_Mail, "MailEntryPriorityEx") Prototype FinishMailDirectoryEx(ID, ErrorOutput) Global FinishMailDirectoryEx.FinishMailDirectoryEx = GetFunction(PBEx_Mail, "FinishMailDirectoryEx") Prototype FinishMailEx(ID, ErrorOutput) Global FinishMailEx.FinishMailEx = GetFunction(PBEx_Mail, "FinishMailEx") Prototype IsMailEx(ID, ErrorOutput) Global IsMailEx.IsMailEx = GetFunction(PBEx_Mail, "IsMailEx") Prototype NextMailDirectoryEntryEx(ID, ErrorOutput) Global NextMailDirectoryEntryEx.NextMailDirectoryEntryEx = GetFunction(PBEx_Mail, "NextMailDirectoryEntryEx") Prototype NextMailEntryEx(ID, ErrorOutput) Global NextMailEntryEx.NextMailEntryEx = GetFunction(PBEx_Mail, "NextMailEntryEx") Prototype SetMailDirectoryEx(ID, DirectoryPath.p-Unicode, ErrorOutput) Global SetMailDirectoryEx.SetMailDirectoryEx = GetFunction(PBEx_Mail, "SetMailDirectoryEx") Prototype CreateMailDirectoryEx(ID, DirectoryName.p-Unicode, ErrorOutput) Global CreateMailDirectoryEx.CreateMailDirectoryEx = GetFunction(PBEx_Mail, "CreateMailDirectoryEx") Prototype RenameMailDirectoryEx(ID, OldDirectoryName.p-Unicode, NewDirectoryName.p-Unicode, ErrorOutput) Global RenameMailDirectoryEx.RenameMailDirectoryEx = GetFunction(PBEx_Mail, "RenameMailDirectoryEx") Prototype DeleteMailDirectoryEx(ID, DirectoryPath.p-Unicode, ErrorOutput) Global DeleteMailDirectoryEx.DeleteMailDirectoryEx = GetFunction(PBEx_Mail, "DeleteMailDirectoryEx") Prototype CreateMailEx(ID, Directory.p-Unicode, Subject.p-Unicode, Body.p-Unicode, Priority, From.p-Unicode, ToAddress.p-Unicode, CC.p-Unicode, BCC.p-Unicode, Attachments.p-Unicode, ErrorOutput) Global CreateMailEx.CreateMailEx = GetFunction(PBEx_Mail, "CreateMailEx") Prototype BindMailEventEx(ID, Event, PBProcedureHandle, PID, ErrorOutput) Global BindMailEventEx.BindMailEventEx = GetFunction(PBEx_Mail, "BindMailEventEx") Prototype GetMailSubjectEx(ID, MailID, DirectoryPath.p-Unicode, Output, ErrorOutput) Global GetMailSubjectEx.GetMailSubjectEx = GetFunction(PBEx_Mail, "GetMailSubjectEx") Prototype GetMailBodyEx(ID, MailID, DirectoryPath.p-Unicode, Output, ErrorOutput) Global GetMailBodyEx.GetMailBodyEx = GetFunction(PBEx_Mail, "GetMailBodyEx") Prototype GetMailFromEx(ID, MailID, DirectoryPath.p-Unicode, Output, ErrorOutput) Global GetMailFromEx.GetMailFromEx = GetFunction(PBEx_Mail, "GetMailFromEx") Prototype GetMailToEx(ID, MailID, DirectoryPath.p-Unicode, Output, ErrorOutput) Global GetMailToEx.GetMailToEx = GetFunction(PBEx_Mail, "GetMailToEx") Prototype GetMailCCEx(ID, MailID, DirectoryPath.p-Unicode, Output, ErrorOutput) Global GetMailCCEx.GetMailCCEx = GetFunction(PBEx_Mail, "GetMailCCEx") Prototype GetMailBCCEx(ID, MailID, DirectoryPath.p-Unicode, Output, ErrorOutput) Global GetMailBCCEx.GetMailBCCEx = GetFunction(PBEx_Mail, "GetMailBCCEx") Prototype GetMailDateEx(ID, MailID, DirectoryPath.p-Unicode, ErrorOutput) Global GetMailDateEx.GetMailDateEx = GetFunction(PBEx_Mail, "GetMailDateEx") Prototype GetMailPriorityEx(ID, MailID, DirectoryPath.p-Unicode, ErrorOutput) Global GetMailPriorityEx.GetMailPriorityEx = GetFunction(PBEx_Mail, "GetMailPriorityEx") Prototype MailEntryBodySizeEx(ID, ErrorOutput) Global MailEntryBodySizeEx.MailEntryBodySizeEx = GetFunction(PBEx_Mail, "MailEntryBodySizeEx") Prototype MailIDEx(ID, ErrorOutput) Global MailIDEx.MailIDEx = GetFunction(PBEx_Mail, "MailIDEx") Prototype SetMailSubjectEx(ID, MailID, Directory.p-Unicode, Text.p-Unicode, ErrorOutput) Global SetMailSubjectEx.SetMailSubjectEx = GetFunction(PBEx_Mail, "SetMailSubjectEx") Prototype SetMailBodyEx(ID, MailID, Directory.p-Unicode, Text.p-Unicode, ErrorOutput) Global SetMailBodyEx.SetMailBodyEx = GetFunction(PBEx_Mail, "SetMailBodyEx") Prototype SetMailFromEx(ID, MailID, Directory.p-Unicode, Text.p-Unicode, ErrorOutput) Global SetMailFromEx.SetMailFromEx = GetFunction(PBEx_Mail, "SetMailFromEx") Prototype SetMailToEx(ID, MailID, Directory.p-Unicode, Text.p-Unicode, ErrorOutput) Global SetMailToEx.SetMailToEx = GetFunction(PBEx_Mail, "SetMailToEx") Prototype SetMailCCEx(ID, MailID, Directory.p-Unicode, Text.p-Unicode, ErrorOutput) Global SetMailCCEx.SetMailCCEx = GetFunction(PBEx_Mail, "SetMailCCEx") Prototype SetMailBCCEx(ID, MailID, Directory.p-Unicode, Text.p-Unicode, ErrorOutput) Global SetMailBCCEx.SetMailBCCEx = GetFunction(PBEx_Mail, "SetMailBCCEx") Prototype SetMailPriorityEx(ID, MailID, Directory.p-Unicode, Priority, ErrorOutput) Global SetMailPriorityEx.SetMailPriorityEx = GetFunction(PBEx_Mail, "SetMailPriorityEx") Prototype DeleteMailEx(ID, MailID, Directory.p-Unicode, ErrorOutput) Global DeleteMailEx.DeleteMailEx = GetFunction(PBEx_Mail, "DeleteMailEx") Prototype MoveMailEx(ID, MailID, Directory.p-Unicode, TargetDirectory.p-Unicode, ErrorOutput) Global MoveMailEx.MoveMailEx = GetFunction(PBEx_Mail, "MoveMailEx") Prototype CountMailEx(ID, Directory.p-Unicode, ErrorOutput) Global CountMailEx.CountMailEx = GetFunction(PBEx_Mail, "CountMailEx") Prototype CountMailDirectoryEx(ID, ErrorOutput) Global CountMailDirectoryEx.CountMailDirectoryEx = GetFunction(PBEx_Mail, "CountMailDirectoryEx") Prototype SendMailEx(ID, Subject.p-Unicode, Body.p-Unicode, Priority, From.p-Unicode, ToAddress.p-Unicode, CC.p-Unicode, BCC.p-Unicode, Attachments.p-Unicode, ErrorOutput) Global SendMailEx.SendMailEx = GetFunction(PBEx_Mail, "SendMailEx") Prototype SaveMailEx(ID, MailID, Directory.p-Unicode, Path.p-Unicode, ErrorOutput) Global SaveMailEx.SaveMailEx = GetFunction(PBEx_Mail, "SaveMailEx") Prototype GetMailHeaderEx(ID, MailID, Directory.p-Unicode, Output, ErrorOutput) Global GetMailHeaderEx.GetMailHeaderEx = GetFunction(PBEx_Mail, "GetMailHeaderEx") Prototype MailEntryHeaderEx(ID, Output, ErrorOutput) Global MailEntryHeaderEx.MailEntryHeaderEx = GetFunction(PBEx_Mail, "MailEntryHeaderEx") Prototype LoadMailEx(ID, Path.p-Unicode, Directory.p-Unicode, ErrorOutput) Global LoadMailEx.LoadMailEx = GetFunction(PBEx_Mail, "LoadMailEx") Prototype SendMailFileEx(ID, Path.p-Unicode, ErrorOutput) Global SendMailFileEx.SendMailFileEx = GetFunction(PBEx_Mail, "SendMailFileEx") Prototype CountMailAttachmentsEx(ID, ErrorOutput) Global CountMailAttachmentsEx.CountMailAttachmentsEx = GetFunction(PBEx_Mail, "CountMailAttachmentsEx") Prototype ExamineMailAttachmentsEx(ID, ErrorOutput) Global ExamineMailAttachmentsEx.ExamineMailAttachmentsEx = GetFunction(PBEx_Mail, "ExamineMailAttachmentsEx") Prototype NextMailEntryAttachmentsEx(ID, ErrorOutput) Global NextMailEntryAttachmentsEx.NextMailEntryAttachmentsEx = GetFunction(PBEx_Mail, "NextMailEntryAttachmentsEx") Prototype MailEntryAttachmentsFileNameEx(ID, Output, ErrorOutput) Global MailEntryAttachmentsFileNameEx.MailEntryAttachmentsFileNameEx = GetFunction(PBEx_Mail, "MailEntryAttachmentsFileNameEx") Prototype SaveMailEntryAttachmentsEx(ID, Path.p-Unicode, ErrorOutput) Global SaveMailEntryAttachmentsEx.SaveMailEntryAttachmentsEx = GetFunction(PBEx_Mail, "SaveMailEntryAttachmentsEx") Prototype FinishMailAttachmentsEx(ID, ErrorOutput) Global FinishMailAttachmentsEx.FinishMailAttachmentsEx = GetFunction(PBEx_Mail, "FinishMailAttachmentsEx") Prototype GetMailAttachmentsEx(ID, MailID, Directory.p-Unicode, ErrorOutput) Global GetMailAttachmentsEx.GetMailAttachmentsEx = GetFunction(PBEx_Mail, "GetMailAttachmentsEx") Prototype SetMailAttachmentsEx(ID, MailID, Directory.p-Unicode, Attachments.p-Unicode, ErrorOutput) Global SetMailAttachmentsEx.SetMailAttachmentsEx = GetFunction(PBEx_Mail, "SetMailAttachmentsEx") Prototype MailEntryAttributeEx(ID, ErrorOutput) Global MailEntryAttributeEx.MailEntryAttributeEx = GetFunction(PBEx_Mail, "MailEntryAttributeEx") Prototype SetMailAttributeEx(ID, MailID, Directory.p-Unicode, Attributes, ErrorOutput) Global SetMailAttributeEx.SetMailAttributeEx = GetFunction(PBEx_Mail, "SetMailAttributeEx") Prototype GetMailAttributeEx(ID, MailID, Directory.p-Unicode, ErrorOutput) Global GetMailAttributeEx.GetMailAttributeEx = GetFunction(PBEx_Mail, "GetMailAttributeEx") EndIf Global Output$ = Space(1000000) Global ErrorOutput$ = Space(128) Procedure NewMail(MailID$) Protected MailID = Val(MailID$) GetMailSubjectEx(1, MailID, "", @Output$, @ErrorOutput$) Debug "Subject: " + Output$ GetMailFromEx(1, MailID, "", @Output$, @ErrorOutput$) Debug "From: " + Output$ GetMailToEx(1, MailID, "", @Output$, @ErrorOutput$) Debug "To: " + Output$ Debug "Date: " + FormatDate("%dd.%mm.%yyyy %hh:%ii:%ss", GetMailDateEx(1, MailID, "", @ErrorOutput$)) EndProcedure If OpenMailEx(1, #PBEx_Mail_Protocol_IMAP, "imap.gmail.com", 993, "yourmailaddress@gmail.com", "YourPassword", 1, #PBEx_Mail_ProtocolVersion_TLS13, @ErrorOutput$) ; ;Notify automatically when new emails arrive. ; If OpenWindow(0, 0, 0, 500, 400, "Window", #PB_Window_SystemMenu | #PB_Window_ScreenCentered) ; ; BindMailEventEx(1, #PBEx_Mail_Event_NewMail, @NewMail(), GetCurrentProcessId_(), @ErrorOutput$) ; ; Repeat ; Select WaitWindowEvent() ; Case #PB_Event_CloseWindow ; End ; EndSelect ; ForEver ; EndIf ; ;Determine all directories (only for IMAP) ; If ExamineMailDirectoryEx(1, @ErrorOutput$) ; While NextMailDirectoryEntryEx(1, @ErrorOutput$) ; MailDirectoryEntryNameEx(1, @Output$, @ErrorOutput$) ; Debug Output$ ; Wend ; ; EndIf ;Determine all mail from inbox ;Or from any directory ;SetMailDirectoryEx(1, "Downloadportale/Chip", @ErrorOutput$) If ExamineMailEx(1, #PBEx_Mail_SeenType_AllMails, #PBEx_Mail_FetchType_AllData, 0, @ErrorOutput$) While NextMailEntryEx(1, @ErrorOutput$) MailEntrySubjectEx(1, @Output$, @ErrorOutput$) Debug "Subject: " + Output$ MailEntryFromEx(1, @Output$, @ErrorOutput$) Debug "From: " + Output$ MailEntryToEx(1, @Output$, @ErrorOutput$) Debug "To: " + Output$ Debug "Date: " + FormatDate("%dd.%mm.%yyyy %hh:%ii:%ss", MailEntryDateEx(1, @ErrorOutput$)) Debug MailIDEx(1, @ErrorOutput$) Debug Str(CountMailAttachmentsEx(1, @ErrorOutput$)) + " attachment(s)" If ExamineMailAttachmentsEx(1, @ErrorOutput$) While NextMailEntryAttachmentsEx(1, @ErrorOutput$) If MailEntryAttachmentsFileNameEx(1, @Output$, @ErrorOutput$) Debug Output$ EndIf Wend EndIf Debug "--------------------------------------------------" Wend EndIf CloseMailEx(1, @ErrorOutput$) Else Debug ErrorOutput$ EndIf CloseLibrary(PBEx_Mail)
- Syntax:
- CloseMailEx()
- Syntax:
Code: Alles auswählen
Result = CloseMailEx(ID, @ErrorOutput$)
- Beschreibung: Schließt die Verbindung zum Mailserver.
- Parameter:
- ID: Die Nummer der Verbindung.
- @ErrorOutput$: Falls ein Fehler auftritt, wird die Fehlermeldung in die String-Variable gespeichert.
- Rückgabewert:
- 1: Der Vorgang war erfolgreich.
- Syntax:
- ExamineMailDirectoryEx()
- Syntax:
Code: Alles auswählen
Result = ExamineMailDirectoryEx(ID, @ErrorOutput$)
- Beschreibung: Startet die Auflistung von der Verzeichnisstruktur. Bei POP3 werden keine Verzeichnisse unterstützt.
- Parameter:
- ID: Die Nummer der Verbindung.
- @ErrorOutput$: Falls ein Fehler auftritt, wird die Fehlermeldung in die String-Variable gespeichert.
- Rückgabewert:
- 1: Der Vorgang war erfolgreich.
- Syntax:
- MailDirectoryEntryNameEx()
- Syntax:
Code: Alles auswählen
Result = MailDirectoryEntryNameEx(ID, @Output, @ErrorOutput$)
- Beschreibung: Der Name des Verzeichnisses wird ermittelt. Diese Funktion ist nur innerhalb der ExamineMailDirectoryEx-Schleife gültig. Diese Funktion wird bei POP3 nicht unterstützt.
- Parameter:
- ID: Die Nummer der Verbindung.
- @Output: Der Name des Verzeichnisses wird in diese Variable gespeichert.
- @ErrorOutput$: Falls ein Fehler auftritt, wird die Fehlermeldung in die String-Variable gespeichert.
- Rückgabewert:
- 1: Der Vorgang war erfolgreich.
- Syntax:
- ExamineMailEx()
- Syntax:
Code: Alles auswählen
Result = ExamineMailEx(ID, SeenType, FetchType, SortByNew, @ErrorOutput$)
- Beschreibung: Startet die Auflistung vom aktuellen Verzeichnis.
- Parameter:
- ID: Die Nummer der Verbindung.
- SeenType: Legt fest, ob alle E-Mails oder nur E-Mails, die bereits gelesen oder noch nicht gelesen wurden, ermittelt werden. Diese Funktion wird bei POP3 nicht unterstützt. Folgende Konstanten können verwendet werden:
- #PBEx_Mail_SeenType_AllMails
- #PBEx_Mail_SeenType_OnlySeenMails
- #PBEx_Mail_SeenType_OnlyUnseenMails
- FetchType: Legt fest, ob alle Daten oder nur die Header-Daten der E-Mails heruntergeladen werden. Diese Funktion wird bei POP3 nicht unterstützt. Folgende Konstanten können verwendet werden:
- #PBEx_Mail_FetchType_AllData
- #PBEx_Mail_FetchType_OnlyHeaderData
- SortByNew: Legt die Reihenfolge zum Ermitteln der E-Mails fest:
- 0: Die E-Mails, die zuerst erstellt wurden, werden zuerst ermittelt.
- 1: Die neusten E-Mails werden zuerst ermittelt.
- @ErrorOutput$: Falls ein Fehler auftritt, wird die Fehlermeldung in die String-Variable gespeichert.
- Rückgabewert:
- 1: Der Vorgang war erfolgreich.
- Syntax:
- MailEntrySubjectEx()
- Syntax:
Code: Alles auswählen
Result = MailEntrySubjectEx(ID, @Output, @ErrorOutput$)
- Beschreibung: Ermittelt den Betreff der E-Mail. Diese Funktion ist nur innerhalb der ExamineMailEx-Schleife gültig.
- Parameter:
- ID: Die Nummer der Verbindung.
- @Output: Betreff der E-Mail wird in diese Variable gespeichert.
- @ErrorOutput$: Falls ein Fehler auftritt, wird die Fehlermeldung in die String-Variable gespeichert.
- Rückgabewert:
- 1: Der Vorgang war erfolgreich.
- Syntax:
- MailEntryBodyEx()
- Syntax:
Code: Alles auswählen
Result = MailEntryBodyEx(ID, @Output, @ErrorOutput$)
- Beschreibung: Ermittelt den Inhalt der E-Mail. Es kann entweder Reintext oder HTML sein. Diese Funktion ist nur innerhalb der ExamineMailEx-Schleife gültig.
- Parameter:
- ID: Die Nummer der Verbindung.
- @Output: Inhalt der E-Mail wird in diese Variable gespeichert.
- @ErrorOutput$: Falls ein Fehler auftritt, wird die Fehlermeldung in die String-Variable gespeichert.
- Rückgabewert:
- 1: Der Vorgang war erfolgreich.
- Syntax:
- MailEntryFromEx()
- Syntax:
Code: Alles auswählen
Result = MailEntryFromEx(ID, @Output, @ErrorOutput$)
- Beschreibung: Ermittelt den Absender der E-Mail. Diese Funktion ist nur innerhalb der ExamineMailEx-Schleife gültig.
- Parameter:
- ID: Die Nummer der Verbindung.
- @Output: Absender der E-Mail wird in diese Variable gespeichert.
- @ErrorOutput$: Falls ein Fehler auftritt, wird die Fehlermeldung in die String-Variable gespeichert.
- Rückgabewert:
- 1: Der Vorgang war erfolgreich.
- Syntax:
- MailEntryToEx()
- Syntax:
Code: Alles auswählen
Result = MailEntryToEx(ID, @Output, @ErrorOutput$)
- Beschreibung: Ermittelt den Empfänger der E-Mail. Diese Funktion ist nur innerhalb der ExamineMailEx-Schleife gültig.
- Parameter:
- ID: Die Nummer der Verbindung.
- @Output: Empfänger der E-Mail wird in diese Variable gespeichert.
- @ErrorOutput$: Falls ein Fehler auftritt, wird die Fehlermeldung in die String-Variable gespeichert.
- Rückgabewert:
- 1: Der Vorgang war erfolgreich.
- Syntax:
- MailEntryCCEx()
- Syntax:
Code: Alles auswählen
Result = MailEntryCCEx(ID, @Output, @ErrorOutput$)
- Beschreibung: Ermittelt den CC-Empfänger (sichtbarer Empfänger) der E-Mail. Diese Funktion ist nur innerhalb der ExamineMailEx-Schleife gültig.
- Parameter:
- ID: Die Nummer der Verbindung.
- @Output: CC-Empfänger der E-Mail wird in diese Variable gespeichert.
- @ErrorOutput$: Falls ein Fehler auftritt, wird die Fehlermeldung in die String-Variable gespeichert.
- Rückgabewert:
- 1: Der Vorgang war erfolgreich.
- Syntax:
- MailEntryBCCEx()
- Syntax:
Code: Alles auswählen
Result = MailEntryBCCEx(ID, @Output, @ErrorOutput$)
- Beschreibung: Ermittelt den BCC-Empfänger (unsichtbarer Empfänger) der E-Mail. Diese Funktion ist nur innerhalb der ExamineMailEx-Schleife gültig.
- Parameter:
- ID: Die Nummer der Verbindung.
- @Output: BCC-Empfänger der E-Mail wird in diese Variable gespeichert.
- @ErrorOutput$: Falls ein Fehler auftritt, wird die Fehlermeldung in die String-Variable gespeichert.
- Rückgabewert:
- 1: Der Vorgang war erfolgreich.
- Syntax:
- MailEntryDateEx()
- Syntax:
Code: Alles auswählen
Result = MailEntryDateEx(ID, @ErrorOutput$)
- Beschreibung: Ermittelt das Datum der E-Mail. Diese Funktion ist nur innerhalb der ExamineMailEx-Schleife gültig.
- Parameter:
- ID: Die Nummer der Verbindung.
- @ErrorOutput$: Falls ein Fehler auftritt, wird die Fehlermeldung in die String-Variable gespeichert.
- Rückgabewert: Das Datum der E-Mail. Der Wert kann mit der Date-Bibliothek verwendet werden.
- Syntax:
- MailEntryPriorityEx()
- Syntax:
Code: Alles auswählen
Result = MailEntryPriorityEx(ID, @ErrorOutput$)
- Beschreibung: Ermittelt die festgelegte Priorität der E-Mail. Diese Funktion ist nur innerhalb der ExamineMailEx-Schleife gültig.
- Parameter:
- ID: Die Nummer der Verbindung.
- @ErrorOutput$: Falls ein Fehler auftritt, wird die Fehlermeldung in die String-Variable gespeichert.
- Rückgabewert: Die Priorität der E-Mail. Folgende Konstanten können abgefragt werden:
- #PBEx_Mail_Priority_Normal
- #PBEx_Mail_Priority_Low
- #PBEx_Mail_Priority_High
- Syntax:
- FinishMailDirectoryEx()
- Syntax:
Code: Alles auswählen
Result = FinishMailDirectoryEx(ID, @ErrorOutput$)
- Beschreibung: Schließt die Auflistung von der Verzeichnisstruktur.
- Parameter:
- ID: Die Nummer der Verbindung.
- @ErrorOutput$: Falls ein Fehler auftritt, wird die Fehlermeldung in die String-Variable gespeichert.
- Rückgabewert:
- 1: Der Vorgang war erfolgreich.
- Syntax:
- FinishMailEx()
- Syntax:
Code: Alles auswählen
Result = FinishMailEx(ID, @ErrorOutput$)
- Beschreibung: Schließt die Auflistung vom aktuellen Verzeichnis.
- Parameter:
- ID: Die Nummer der Verbindung.
- @ErrorOutput$: Falls ein Fehler auftritt, wird die Fehlermeldung in die String-Variable gespeichert.
- Rückgabewert:
- 1: Der Vorgang war erfolgreich.
- Syntax:
- IsMailEx()
- Syntax:
Code: Alles auswählen
Result = IsMailEx(ID, @ErrorOutput$)
- Beschreibung: Überprüft, ob die Verbindung noch gültig ist.
- Parameter:
- ID: Die Nummer der Verbindung.
- @ErrorOutput$: Falls ein Fehler auftritt, wird die Fehlermeldung in die String-Variable gespeichert.
- Rückgabewert:
- 1: ID ist gültig.
- Syntax:
- NextMailDirectoryEntryEx()
- Syntax:
Code: Alles auswählen
Result = NextMailDirectoryEntryEx(ID, @ErrorOutput$)
- Beschreibung: Das nächste Verzeichnis wird ermittelt. Diese Funktion wird bei POP3 nicht unterstützt.
- Parameter:
- ID: Die Nummer der Verbindung.
- @ErrorOutput$: Falls ein Fehler auftritt, wird die Fehlermeldung in die String-Variable gespeichert.
- Rückgabewert:
- 1: Der Vorgang war erfolgreich.
- Syntax:
- NextMailEntryEx()
- Syntax:
Code: Alles auswählen
Result = NextMailEntryEx(ID, @ErrorOutput$)
- Beschreibung: Die nächste E-Mail wird ermittelt.
- Parameter:
- ID: Die Nummer der Verbindung.
- @ErrorOutput$: Falls ein Fehler auftritt, wird die Fehlermeldung in die String-Variable gespeichert.
- Rückgabewert:
- 1: Der Vorgang war erfolgreich.
- Syntax:
- SetMailDirectoryEx()
- Syntax:
Code: Alles auswählen
Result = SetMailDirectoryEx(ID, DirectoryPath$, @ErrorOutput$)
- Beschreibung: Öffnet das Verzeichnis, um die E-Mails dieses Verzeichnisses zu ermitteln. Diese Funktion wird bei POP3 nicht unterstützt.
- Parameter:
- ID: Die Nummer der Verbindung.
- DirectoryPath$: Name oder vollständiger Pfad des Verzeichnisses. Wenn leer, dann wird das Posteingang-Verzeichnis ausgewählt.
- @ErrorOutput$: Falls ein Fehler auftritt, wird die Fehlermeldung in die String-Variable gespeichert.
- Rückgabewert:
- 1: Der Vorgang war erfolgreich.
- Syntax:
- CreateMailDirectoryEx()
- Syntax:
Code: Alles auswählen
Result = CreateMailDirectoryEx(ID, DirectoryName$, @ErrorOutput$)
- Beschreibung: Erstellt ein neues Verzeichnis. Diese Funktion wird bei POP3 nicht unterstützt.
- Parameter:
- ID: Die Nummer der Verbindung.
- DirectoryName$: Name des Verzeichnisses.
- @ErrorOutput$: Falls ein Fehler auftritt, wird die Fehlermeldung in die String-Variable gespeichert.
- Rückgabewert:
- 1: Der Vorgang war erfolgreich.
- Syntax:
- RenameMailDirectoryEx()
- Syntax:
Code: Alles auswählen
Result = RenameMailDirectoryEx(ID, OldDirectoryName$, NewDirectoryName$, @ErrorOutput$)
- Beschreibung: Benennt ein vorhandenes Verzeichnis um. Diese Funktion wird bei POP3 nicht unterstützt.
- Parameter:
- ID: Die Nummer der Verbindung.
- OldDirectoryName$: Name des Verzeichnisses.
- NewDirectoryName$: Neuer Name für das Verzeichnis.
- @ErrorOutput$: Falls ein Fehler auftritt, wird die Fehlermeldung in die String-Variable gespeichert.
- Rückgabewert:
- 1: Der Vorgang war erfolgreich.
- Syntax:
- DeleteMailDirectoryEx()
- Syntax:
Code: Alles auswählen
Result = DeleteMailDirectoryEx(ID, DirectoryName$, @ErrorOutput$)
- Beschreibung: Entfernt ein vorhandenes Verzeichnis. Diese Funktion wird bei POP3 nicht unterstützt.
- Parameter:
- ID: Die Nummer der Verbindung.
- DirectoryName$: Name des Verzeichnisses.
- @ErrorOutput$: Falls ein Fehler auftritt, wird die Fehlermeldung in die String-Variable gespeichert.
- Rückgabewert:
- 1: Der Vorgang war erfolgreich.
- Syntax:
- CreateMailEx()
- Syntax:
Code: Alles auswählen
Result = CreateMailEx(ID, Directory$, Subject$, Body$, Priority, From$, ToAddress$, CC$, BCC$, Attachments$, @ErrorOutput$)
- Beschreibung: Erstellt eine neue E-Mail, die aber nicht gesendet wird.
- Parameter:
- ID: Die Nummer der Verbindung.
- Directory$: Name des Verzeichnisses
- Subject$: Betreff der E-Mail
- Body$: Inhalt der E-Mail
- Priority: Festlegung der Priorität. Eine der folgenden Konstanten kann verwendet werden:
- #PBEx_Mail_Priority_Normal
- #PBEx_Mail_Priority_Low
- #PBEx_Mail_Priority_High
- From$: E-Mail-Adresse des Absender.
- ToAddress$: E-Mail-Adresse des Empfänger. Mehrere E-Mail-Adressen können mit Semikolon getrennt werden.
- CC$: E-Mail-Adresse des Empfänger (sichtbarer Empfänger). Mehrere E-Mail-Adressen können mit Semikolon getrennt werden.
- BCC$: E-Mail-Adresse des Empfänger (unsichtbarer Empfänger). Mehrere E-Mail-Adressen können mit Semikolon getrennt werden.
- Attachments$: Vollständiger Pfad zur Datei, die als Anhang hinzugefügt werden soll. Mehrere Anhänge können mit dem |-Zeichen getrennt werden.
- @ErrorOutput$: Falls ein Fehler auftritt, wird die Fehlermeldung in die String-Variable gespeichert.
- Rückgabewert:
- 1: Der Vorgang war erfolgreich.
- Syntax:
- BindMailEventEx()
- Syntax:
Code: Alles auswählen
Result = BindMailEventEx(ID, Event, @PBProcedure(), PID, @ErrorOutput$)
- Beschreibung: Verknüft eine Prozedur mit einem Event.
- Parameter:
- ID: Die Nummer der Verbindung.
- Event: Legt das Event fest, welches abgefragt werden soll. Eine der folgenden Konstanten kann verwendet werden:
- #PBEx_Mail_Event_NewMail: Das Event wird ausgelöst, sobald neue E-Mails vorhanden sind.
- @PBProcedure(): Die Handle-Nummer der Prozedur, die automatisch aufgerufen wird, wenn das festgelegte Event ausgelöst wurde.
- PID: Die PID-Nummer des eigenen Programms.
- @ErrorOutput$: Falls ein Fehler auftritt, wird die Fehlermeldung in die String-Variable gespeichert.
- Rückgabewert:
- 1: Der Vorgang war erfolgreich.
- Syntax:
- GetMailSubjectEx()
- Syntax:
Code: Alles auswählen
Result = GetMailSubjectEx(ID, MailID, DirectoryPath$, @Output$, @ErrorOutput$)
- Beschreibung: Ermittelt mit Hilfe der MailID den Betreff.
- Parameter:
- ID: Die Nummer der Verbindung.
- MailID: Die Nummer einer einzelnen E-Mail.
- DirectoryPath$: Der Name oder vollständiger Pfad zum Verzeichnis, in dem sich die angegebene E-Mail befindet. Wenn leer, dann wird das Posteingang-Verzeichnis ausgewählt.
- @Output$: Der Betreff wird in diese Variable gespeichert.
- @ErrorOutput$: Falls ein Fehler auftritt, wird die Fehlermeldung in die String-Variable gespeichert.
- Rückgabewert:
- 1: Der Vorgang war erfolgreich.
- Syntax:
- GetMailBodyEx()
- Syntax:
Code: Alles auswählen
Result = GetMailBodyEx(ID, MailID, DirectoryPath$, @Output$, @ErrorOutput$)
- Beschreibung: Ermittelt mit Hilfe der MailID den Inhalt.
- Parameter:
- ID: Die Nummer der Verbindung.
- MailID: Die Nummer einer einzelnen E-Mail.
- DirectoryPath$: Der Name oder vollständiger Pfad zum Verzeichnis, in dem sich die angegebene E-Mail befindet. Wenn leer, dann wird das Posteingang-Verzeichnis ausgewählt.
- @Output$: Der Inhalt wird in diese Variable gespeichert.
- @ErrorOutput$: Falls ein Fehler auftritt, wird die Fehlermeldung in die String-Variable gespeichert.
- Rückgabewert:
- 1: Der Vorgang war erfolgreich.
- Syntax:
- GetMailFromEx()
- Syntax:
Code: Alles auswählen
Result = GetMailFromEx(ID, MailID, DirectoryPath$, @Output$, @ErrorOutput$)
- Beschreibung: Ermittelt mit Hilfe der MailID den Absender.
- Parameter:
- ID: Die Nummer der Verbindung.
- MailID: Die Nummer einer einzelnen E-Mail.
- DirectoryPath$: Der Name oder vollständiger Pfad zum Verzeichnis, in dem sich die angegebene E-Mail befindet. Wenn leer, dann wird das Posteingang-Verzeichnis ausgewählt.
- @Output$: Der Absender wird in diese Variable gespeichert.
- @ErrorOutput$: Falls ein Fehler auftritt, wird die Fehlermeldung in die String-Variable gespeichert.
- Rückgabewert:
- 1: Der Vorgang war erfolgreich.
- Syntax:
- GetMailToEx()
- Syntax:
Code: Alles auswählen
Result = GetMailToEx(ID, MailID, DirectoryPath$, @Output$, @ErrorOutput$)
- Beschreibung: Ermittelt mit Hilfe der MailID den Empfänger.
- Parameter:
- ID: Die Nummer der Verbindung.
- MailID: Die Nummer einer einzelnen E-Mail.
- DirectoryPath$: Der Name oder vollständiger Pfad zum Verzeichnis, in dem sich die angegebene E-Mail befindet. Wenn leer, dann wird das Posteingang-Verzeichnis ausgewählt.
- @Output$: Der Empfänger wird in diese Variable gespeichert.
- @ErrorOutput$: Falls ein Fehler auftritt, wird die Fehlermeldung in die String-Variable gespeichert.
- Rückgabewert:
- 1: Der Vorgang war erfolgreich.
- Syntax:
- GetMailCCEx()
- Syntax:
Code: Alles auswählen
Result = GetMailCCEx(ID, MailID, DirectoryPath$, @Output$, @ErrorOutput$)
- Beschreibung: Ermittelt mit Hilfe der MailID den CC-Empfänger. (sichtbarer Empfänger)
- Parameter:
- ID: Die Nummer der Verbindung.
- MailID: Die Nummer einer einzelnen E-Mail.
- DirectoryPath$: Der Name oder vollständiger Pfad zum Verzeichnis, in dem sich die angegebene E-Mail befindet. Wenn leer, dann wird das Posteingang-Verzeichnis ausgewählt.
- @Output$: Der CC-Empfänger wird in diese Variable gespeichert.
- @ErrorOutput$: Falls ein Fehler auftritt, wird die Fehlermeldung in die String-Variable gespeichert.
- Rückgabewert:
- 1: Der Vorgang war erfolgreich.
- Syntax:
- GetMailBCCEx()
- Syntax:
Code: Alles auswählen
Result = GetMailBCCEx(ID, MailID, DirectoryPath$, @Output$, @ErrorOutput$)
- Beschreibung: Ermittelt mit Hilfe der MailID den BCC-Empfänger. (unsichtbarer Empfänger)
- Parameter:
- ID: Die Nummer der Verbindung.
- MailID: Die Nummer einer einzelnen E-Mail.
- DirectoryPath$: Der Name oder vollständiger Pfad zum Verzeichnis, in dem sich die angegebene E-Mail befindet. Wenn leer, dann wird das Posteingang-Verzeichnis ausgewählt.
- @Output$: Der BCC-Empfänger wird in diese Variable gespeichert.
- @ErrorOutput$: Falls ein Fehler auftritt, wird die Fehlermeldung in die String-Variable gespeichert.
- Rückgabewert:
- 1: Der Vorgang war erfolgreich.
- Syntax:
- GetMailDateEx()
- Syntax:
Code: Alles auswählen
Result = GetMailDateEx(ID, MailID, DirectoryPath$, @ErrorOutput$)
- Beschreibung: Ermittelt mit Hilfe der MailID das Datum.
- Parameter:
- ID: Die Nummer der Verbindung.
- MailID: Die Nummer einer einzelnen E-Mail.
- DirectoryPath$: Der Name oder vollständiger Pfad zum Verzeichnis, in dem sich die angegebene E-Mail befindet. Wenn leer, dann wird das Posteingang-Verzeichnis ausgewählt.
- @ErrorOutput$: Falls ein Fehler auftritt, wird die Fehlermeldung in die String-Variable gespeichert.
- Rückgabewert: Das Datum der E-Mail. Der Wert kann mit der Date-Bibliothek verwendet werden.
- Syntax:
- GetMailPriorityEx()
- Syntax:
Code: Alles auswählen
Result = GetMailPriorityEx(ID, MailID, DirectoryPath$, @ErrorOutput$)
- Beschreibung: Ermittelt mit Hilfe der MailID die Priorität.
- Parameter:
- ID: Die Nummer der Verbindung.
- MailID: Die Nummer einer einzelnen E-Mail.
- DirectoryPath$: Der Name oder vollständiger Pfad zum Verzeichnis, in dem sich die angegebene E-Mail befindet. Wenn leer, dann wird das Posteingang-Verzeichnis ausgewählt.
- @ErrorOutput$: Falls ein Fehler auftritt, wird die Fehlermeldung in die String-Variable gespeichert.
- Rückgabewert: Die Priorität der E-Mail. Folgende Konstanten können abgefragt werden:
- #PBEx_Mail_Priority_Normal
- #PBEx_Mail_Priority_Low
- #PBEx_Mail_Priority_High
- Syntax:
- MailEntryBodySizeEx()
- Syntax:
Code: Alles auswählen
Result = MailEntryBodySizeEx(ID, @ErrorOutput$)
- Beschreibung: Ermittelt die Größe in Bytes für das Allokieren des Speichers.
- Parameter:
- ID: Die Nummer der Verbindung.
- @ErrorOutput$: Falls ein Fehler auftritt, wird die Fehlermeldung in die String-Variable gespeichert.
- Rückgabewert: Größe in Bytes
- Syntax:
- MailIDEx()
- Syntax:
Code: Alles auswählen
Result = MailIDEx(ID, @ErrorOutput$)
- Beschreibung: Ermittelt die Mail-ID, um damit Eigenschaften auszulesen oder zu ändern. Diese Funktion ist nur innerhalb der ExamineMailEx-Schleife gültig.
- Parameter:
- ID: Die Nummer der Verbindung.
- @ErrorOutput$: Falls ein Fehler auftritt, wird die Fehlermeldung in die String-Variable gespeichert.
- Rückgabewert: ID der E-Mail
- Syntax:
- SetMailSubjectEx()
- Syntax:
Code: Alles auswählen
Result = SetMailSubjectEx(ID, MailID, Directory$, Text$, @ErrorOutput$)
- Beschreibung: Ändert mit Hilfe der Mail-ID den Betreff. Aufgrund der Spezifikation, dass die E-Mail nicht nachträglich modifiziert werden darf, wird die geänderte E-Mail als neue E-Mail gespeichert. Diese Funktion wird bei POP3 nicht unterstützt.
- Parameter:
- ID: Die Nummer der Verbindung.
- MailID: ID der E-Mail
- Directory$: Name des Verzeichnisses
- Text$: Ändert mit dem angegebenen Wert.
- @ErrorOutput$: Falls ein Fehler auftritt, wird die Fehlermeldung in die String-Variable gespeichert.
- Rückgabewert:
- 1: Der Vorgang war erfolgreich.
- Syntax:
- SetMailBodyEx()
- Syntax:
Code: Alles auswählen
Result = SetMailBodyEx(ID, MailID, Directory$, Text$, @ErrorOutput$)
- Beschreibung: Ändert mit Hilfe der Mail-ID den Inhalt. Aufgrund der Spezifikation, dass die E-Mail nicht nachträglich modifiziert werden darf, wird die geänderte E-Mail als neue E-Mail gespeichert. Diese Funktion wird bei POP3 nicht unterstützt.
- Parameter:
- ID: Die Nummer der Verbindung.
- MailID: ID der E-Mail
- Directory$: Name des Verzeichnisses
- Text$: Ändert mit dem angegebenen Wert.
- @ErrorOutput$: Falls ein Fehler auftritt, wird die Fehlermeldung in die String-Variable gespeichert.
- Rückgabewert:
- 1: Der Vorgang war erfolgreich.
- Syntax:
- SetMailFromEx()
- Syntax:
Code: Alles auswählen
Result = SetMailFromEx(ID, MailID, Directory$, Text$, @ErrorOutput$)
- Beschreibung: Ändert mit Hilfe der Mail-ID den Absender. Aufgrund der Spezifikation, dass die E-Mail nicht nachträglich modifiziert werden darf, wird die geänderte E-Mail als neue E-Mail gespeichert. Diese Funktion wird bei POP3 nicht unterstützt.
- Parameter:
- ID: Die Nummer der Verbindung.
- MailID: ID der E-Mail
- Directory$: Name des Verzeichnisses
- Text$: Ändert mit dem angegebenen Wert.
- @ErrorOutput$: Falls ein Fehler auftritt, wird die Fehlermeldung in die String-Variable gespeichert.
- Rückgabewert:
- 1: Der Vorgang war erfolgreich.
- Syntax:
- SetMailToEx()
- Syntax:
Code: Alles auswählen
Result = SetMailToEx(ID, MailID, Directory$, Text$, @ErrorOutput$)
- Beschreibung: Ändert mit Hilfe der Mail-ID den Empfänger. Aufgrund der Spezifikation, dass die E-Mail nicht nachträglich modifiziert werden darf, wird die geänderte E-Mail als neue E-Mail gespeichert. Diese Funktion wird bei POP3 nicht unterstützt.
- Parameter:
- ID: Die Nummer der Verbindung.
- MailID: ID der E-Mail
- Directory$: Name des Verzeichnisses
- Text$: Ändert mit dem angegebenen Wert. Mehrere E-Mail-Adressen können mit Semikolon getrennt werden.
- @ErrorOutput$: Falls ein Fehler auftritt, wird die Fehlermeldung in die String-Variable gespeichert.
- Rückgabewert:
- 1: Der Vorgang war erfolgreich.
- Syntax:
- SetMailCCEx()
- Syntax:
Code: Alles auswählen
Result = SetMailCCEx(ID, MailID, Directory$, Text$, @ErrorOutput$)
- Beschreibung: Ändert mit Hilfe der Mail-ID den CC-Empfänger (sichtbarer Empfänger). Aufgrund der Spezifikation, dass die E-Mail nicht nachträglich modifiziert werden darf, wird die geänderte E-Mail als neue E-Mail gespeichert. Diese Funktion wird bei POP3 nicht unterstützt.
- Parameter:
- ID: Die Nummer der Verbindung.
- MailID: ID der E-Mail
- Directory$: Name des Verzeichnisses
- Text$: Ändert mit dem angegebenen Wert. Mehrere E-Mail-Adressen können mit Semikolon getrennt werden.
- @ErrorOutput$: Falls ein Fehler auftritt, wird die Fehlermeldung in die String-Variable gespeichert.
- Rückgabewert:
- 1: Der Vorgang war erfolgreich.
- Syntax:
- SetMailBCCEx()
- Syntax:
Code: Alles auswählen
Result = SetMailBCCEx(ID, MailID, Directory$, Text$, @ErrorOutput$)
- Beschreibung: Ändert mit Hilfe der Mail-ID den BCC-Empfänger (unsichtbarer Empfänger). Aufgrund der Spezifikation, dass die E-Mail nicht nachträglich modifiziert werden darf, wird die geänderte E-Mail als neue E-Mail gespeichert. Diese Funktion wird bei POP3 nicht unterstützt.
- Parameter:
- ID: Die Nummer der Verbindung.
- MailID: ID der E-Mail
- Directory$: Name des Verzeichnisses
- Text$: Ändert mit dem angegebenen Wert. Mehrere E-Mail-Adressen können mit Semikolon getrennt werden.
- @ErrorOutput$: Falls ein Fehler auftritt, wird die Fehlermeldung in die String-Variable gespeichert.
- Rückgabewert:
- 1: Der Vorgang war erfolgreich.
- Syntax:
- SetMailPriorityEx()
- Syntax:
Code: Alles auswählen
Result = SetMailPriorityEx(ID, MailID, Directory$, Priority, @ErrorOutput$)
- Beschreibung: Ändert mit Hilfe der Mail-ID die Priorität. Aufgrund der Spezifikation, dass die E-Mail nicht nachträglich modifiziert werden darf, wird die geänderte E-Mail als neue E-Mail gespeichert. Diese Funktion wird bei POP3 nicht unterstützt.
- Parameter:
- ID: Die Nummer der Verbindung.
- MailID: ID der E-Mail
- Directory$: Name des Verzeichnisses
- Priority: Priorität der E-Mail. Eine der folgenden Konstanten kann verwendet werden:
- #PBEx_Mail_Priority_Normal
- #PBEx_Mail_Priority_Low
- #PBEx_Mail_Priority_High
- @ErrorOutput$: Falls ein Fehler auftritt, wird die Fehlermeldung in die String-Variable gespeichert.
- Rückgabewert:
- 1: Der Vorgang war erfolgreich.
- Syntax:
- DeleteMailEx()
- Syntax:
Code: Alles auswählen
Result = DeleteMailEx(ID, MailID, Directory$, @ErrorOutput$)
- Beschreibung: Entfernt mit Hilfe der Mail-ID und des Verzeichnisses die E-Mail. Diese Funktion wird bei POP3 nicht unterstützt.
- Parameter:
- ID: Die Nummer der Verbindung.
- MailID: ID der E-Mail
- Directory$: Name oder vollständiger Pfad zum Verzeichnis, in dem sich die angegebene E-Mail befindet. Wenn leer, dann wird das Posteingang-Verzeichnis ausgewählt.
- @ErrorOutput$: Falls ein Fehler auftritt, wird die Fehlermeldung in die String-Variable gespeichert.
- Rückgabewert:
- 1: Der Vorgang war erfolgreich.
- Syntax:
- MoveMailEx()
- Syntax:
Code: Alles auswählen
Result = MoveMailEx(ID, MailID, Directory$, TargetDirectory$, @ErrorOutput$)
- Beschreibung: Verschiebt mit Hilfe der Mail-ID und des Quellverzeichnisses die E-Mail in das angegebene Zielverzeichnis. Diese Funktion wird bei POP3 nicht unterstützt.
- Parameter:
- ID: Die Nummer der Verbindung.
- MailID: ID der E-Mail
- Directory$: Name oder vollständiger Pfad zum Verzeichnis, in dem sich die angegebene E-Mail befindet. Wenn leer, dann wird das Posteingang-Verzeichnis ausgewählt.
- TargetDirectory$: Name oder vollständiger Pfad zum Verzeichnis, in das die E-Mail verschoben werden soll. Wenn leer, dann wird das Posteingang-Verzeichnis ausgewählt.
- @ErrorOutput$: Falls ein Fehler auftritt, wird die Fehlermeldung in die String-Variable gespeichert.
- Rückgabewert:
- 1: Der Vorgang war erfolgreich.
- Syntax:
- CountMailEx()
- Syntax:
Code: Alles auswählen
Result = CountMailEx(ID, Directory$, @ErrorOutput$)
- Beschreibung: Ermittelt, wie viele E-Mails im angegebenen Verzeichnis existieren.
- Parameter:
- ID: Die Nummer der Verbindung.
- Directory$: Name oder vollständiger Pfad zum Verzeichnis. Wenn leer, dann wird das Posteingang-Verzeichnis ausgewählt.
- @ErrorOutput$: Falls ein Fehler auftritt, wird die Fehlermeldung in die String-Variable gespeichert.
- Rückgabewert: Anzahl der E-Mails
- Syntax:
- CountMailDirectoryEx()
- Syntax:
Code: Alles auswählen
Result = CountMailDirectoryEx(ID, @ErrorOutput$)
- Beschreibung: Ermittelt, wie viele Verzeichnisse existieren. Diese Funktion wird bei POP3 nicht unterstützt.
- Parameter:
- ID: Die Nummer der Verbindung.
- @ErrorOutput$: Falls ein Fehler auftritt, wird die Fehlermeldung in die String-Variable gespeichert.
- Rückgabewert: Anzahl der Verzeichnisse
- Syntax:
- SendMailEx()
- Syntax:
Code: Alles auswählen
Result = SendMailEx(ID, Subject$, Body$, Priority, From$, ToAddress$, CC$, BCC$, Attachments$, @ErrorOutput$)
- Beschreibung: Sendet eine neue E-Mail.
- Parameter:
- ID: Die Nummer der Verbindung.
- Subject$: Betreff der E-Mail
- Body$: Inhalt der E-Mail
- Priority: Festlegung der Priorität. Eine der folgenden Konstanten kann verwendet werden:
- #PBEx_Mail_Priority_Normal
- #PBEx_Mail_Priority_Low
- #PBEx_Mail_Priority_High
- From$: E-Mail-Adresse des Absender.
- ToAddress$: E-Mail-Adresse des Empfänger. Mehrere E-Mail-Adressen können mit Semikolon getrennt werden.
- CC$: E-Mail-Adresse des Empfänger (sichtbarer Empfänger). Mehrere E-Mail-Adressen können mit Semikolon getrennt werden.
- BCC$: E-Mail-Adresse des Empfänger (unsichtbarer Empfänger). Mehrere E-Mail-Adressen können mit Semikolon getrennt werden.
- Attachments$: Vollständiger Pfad zur Datei, die als Anhang hinzugefügt werden soll. Mehrere Anhänge können mit dem |-Zeichen getrennt werden. Aliasse werden unterstützt. Beispiel: OriginalDatei.zip<AliasDatei.zip>
- @ErrorOutput$: Falls ein Fehler auftritt, wird die Fehlermeldung in die String-Variable gespeichert.
- Rückgabewert:
- 1: Der Vorgang war erfolgreich.
- Syntax:
- SaveMailEx()
- Syntax:
Code: Alles auswählen
Result = SaveMailEx(ID, MailID, Directory$, Path$, @ErrorOutput$)
- Beschreibung: Speichert eine vorhandene E-Mail als EML-Datei auf die Festplatte.
- Parameter:
- ID: Die Nummer der Verbindung.
- MailID: Die Nummer einer einzelnen E-Mail.
- DirectoryPath$: Der Name oder vollständiger Pfad zum Verzeichnis, in dem sich die angegebene E-Mail befindet. Wenn leer, dann wird das Posteingang-Verzeichnis ausgewählt.
- Path$: Vollständiger Pfad inkl. Dateiname, wohin die E-Mail exportiert werden soll.
- @ErrorOutput$: Falls ein Fehler auftritt, wird die Fehlermeldung in die String-Variable gespeichert.
- Rückgabewert:
- 1: Der Vorgang war erfolgreich.
- Syntax:
- GetMailHeaderEx()
- Syntax:
Code: Alles auswählen
Result = GetMailHeaderEx(ID, MailID, Directory$, @Output$, @ErrorOutput$)
- Beschreibung: Ermittelt mit Hilfe der MailID den vollständigen Header der E-Mail.
- Parameter:
- ID: Die Nummer der Verbindung.
- MailID: Die Nummer einer einzelnen E-Mail.
- DirectoryPath$: Der Name oder vollständiger Pfad zum Verzeichnis, in dem sich die angegebene E-Mail befindet. Wenn leer, dann wird das Posteingang-Verzeichnis ausgewählt.
- @Output$: Der Header wird in diese Variable gespeichert.
- @ErrorOutput$: Falls ein Fehler auftritt, wird die Fehlermeldung in die String-Variable gespeichert.
- Rückgabewert:
- 1: Der Vorgang war erfolgreich.
- Syntax:
- MailEntryHeaderEx()
- Syntax:
Code: Alles auswählen
Result = MailEntryHeaderEx(ID, @Output, @ErrorOutput$)
- Beschreibung: Ermittelt den Header der E-Mail. Diese Funktion ist nur innerhalb der ExamineMailEx-Schleife gültig.
- Parameter:
- ID: Die Nummer der Verbindung.
- @Output$: Der Header wird in diese Variable gespeichert.
- @ErrorOutput$: Falls ein Fehler auftritt, wird die Fehlermeldung in die String-Variable gespeichert.
- Rückgabewert:
- 1: Der Vorgang war erfolgreich.
- Syntax:
- LoadMailEx()
- Syntax:
Code: Alles auswählen
Result = LoadMailEx(ID, Path$, Directory$, @ErrorOutput$)
- Beschreibung: Importiert eine EML-Datei in das angegebene Verzeichnis. Diese Funktion wird bei POP3 nicht unterstützt.
- Parameter:
- ID: Die Nummer der Verbindung.
- Path$: Vollständiger Pfad zur EML-Datei.
- Directory$: Name oder vollständiger Pfad zum Verzeichnis. Wenn leer, dann wird das Posteingang-Verzeichnis ausgewählt.
- @ErrorOutput$: Falls ein Fehler auftritt, wird die Fehlermeldung in die String-Variable gespeichert.
- Rückgabewert: MailID der importierten E-Mail.
- Syntax:
- SendMailFileEx()
- Syntax:
Code: Alles auswählen
Result = SendMailFileEx(ID, Path$, @ErrorOutput$)
- Beschreibung: Sendet eine E-Mail mit Hilfe einer EML-Datei.
- Parameter:
- ID: Die Nummer der Verbindung.
- Path$: Vollständiger Pfad zur EML-Datei.
- @ErrorOutput$: Falls ein Fehler auftritt, wird die Fehlermeldung in die String-Variable gespeichert.
- Rückgabewert:
- 1: Der Vorgang war erfolgreich.
- Syntax:
- CountMailAttachmentsEx()
- Syntax:
Code: Alles auswählen
Result = CountMailAttachmentsEx(ID, @ErrorOutput$)
- Beschreibung: Ermittelt, wie viele Anhänge in der aktuellen E-Mail existieren. Diese Funktion ist nur innerhalb der ExamineMailEx-Schleife gültig.
- Parameter:
- ID: Die Nummer der Verbindung.
- @ErrorOutput$: Falls ein Fehler auftritt, wird die Fehlermeldung in die String-Variable gespeichert.
- Rückgabewert: Anzahl der Anhänge
- Syntax:
- ExamineMailAttachmentsEx()
- Syntax:
Code: Alles auswählen
Result = ExamineMailAttachmentsEx(ID, @ErrorOutput$)
- Beschreibung: Startet die Auflistung der Anhänge von der aktuellen E-Mail. Diese Funktion ist nur innerhalb der ExamineMailEx-Schleife gültig oder wenn vorher GetMailAttachmentsEx() aufgerufen wurde.
- Parameter:
- ID: Die Nummer der Verbindung.
- @ErrorOutput$: Falls ein Fehler auftritt, wird die Fehlermeldung in die String-Variable gespeichert.
- Rückgabewert:
- 1: Der Vorgang war erfolgreich.
- Syntax:
- NextMailEntryAttachmentsEx()
- Syntax:
Code: Alles auswählen
Result = NextMailEntryAttachmentsEx(ID, @ErrorOutput$)
- Beschreibung: Der nächste Anhang der aktuellen E-Mail wird ermittelt.
- Parameter:
- ID: Die Nummer der Verbindung.
- @ErrorOutput$: Falls ein Fehler auftritt, wird die Fehlermeldung in die String-Variable gespeichert.
- Rückgabewert:
- 1: Der Vorgang war erfolgreich.
- Syntax:
- MailEntryAttachmentsFileNameEx()
- Syntax:
Code: Alles auswählen
Result = MailEntryAttachmentsFileNameEx(ID, @Output, @ErrorOutput$)
- Beschreibung: Ermittelt den Dateinamen des Anhangs aus der aktuellen E-Mail. Diese Funktion ist nur innerhalb der ExamineMailAttachmentsEx-Schleife gültig oder wenn vorher GetMailAttachmentsEx() aufgerufen wurde.
- Parameter:
- ID: Die Nummer der Verbindung.
- @Output: Dateiname des Anhangs wird in diese Variable gespeichert.
- @ErrorOutput$: Falls ein Fehler auftritt, wird die Fehlermeldung in die String-Variable gespeichert.
- Rückgabewert:
- 1: Der Vorgang war erfolgreich.
- Syntax:
- SaveMailEntryAttachmentsEx()
- Syntax:
Code: Alles auswählen
Result = SaveMailEntryAttachmentsEx(ID, Path$, @ErrorOutput$)
- Beschreibung: Speichert den Anhang als Datei auf die Festplatte. Diese Funktion ist nur innerhalb der ExamineMailAttachmentsEx-Schleife gültig oder wenn vorher GetMailAttachmentsEx() aufgerufen wurde.
- Parameter:
- ID: Die Nummer der Verbindung.
- Path$: Vollständiger Pfad inkl. Dateiname, wohin der Anhang exportiert werden soll.
- @ErrorOutput$: Falls ein Fehler auftritt, wird die Fehlermeldung in die String-Variable gespeichert.
- Rückgabewert:
- 1: Der Vorgang war erfolgreich.
- Syntax:
- FinishMailAttachmentsEx()
- Syntax:
Code: Alles auswählen
Result = FinishMailAttachmentsEx(ID, @ErrorOutput$)
- Beschreibung: Schließt die Auflistung der Anhänge von der aktuellen E-Mail. Diese Funktion ist nur innerhalb der ExamineMailEx-Schleife gültig oder wenn vorher GetMailAttachmentsEx() aufgerufen wurde.
- Parameter:
- ID: Die Nummer der Verbindung.
- @ErrorOutput$: Falls ein Fehler auftritt, wird die Fehlermeldung in die String-Variable gespeichert.
- Rückgabewert:
- 1: Der Vorgang war erfolgreich.
- Syntax:
- GetMailAttachmentsEx()
- Syntax:
Code: Alles auswählen
Result = GetMailAttachmentsEx(ID, MailID, DirectoryPath$, @ErrorOutput$)
- Beschreibung: Legt für die Auflistung der Anhänge die E-Mail. Diese Funktion kann vor ExamineMailAttachmentsEx-Schleife aufgerufen werden, damit die Funktion ExamineMailAttachmentsEx() nicht alle E-Mails, sondern die angegebene E-Mail ermittelt.
- Parameter:
- ID: Die Nummer der Verbindung.
- MailID: Die Nummer der E-Mail.
- DirectoryPath$: Der Name oder vollständiger Pfad zum Verzeichnis, in dem sich die angegebene E-Mail befindet. Wenn leer, dann wird das Posteingang-Verzeichnis ausgewählt.
- @ErrorOutput$: Falls ein Fehler auftritt, wird die Fehlermeldung in die String-Variable gespeichert.
- Rückgabewert:
- 1: Der Vorgang war erfolgreich.
- Syntax:
- SetMailAttachmentsEx()
- Syntax:
Code: Alles auswählen
Result = SetMailAttachmentsEx(ID, MailID, DirectoryPath$, Attachments$, @ErrorOutput$)
- Beschreibung: Fügt Dateien als Anhang hinzu.
- Parameter:
- ID: Die Nummer der Verbindung.
- MailID: Die Nummer der E-Mail.
- DirectoryPath$: Der Name oder vollständiger Pfad zum Verzeichnis, in dem sich die angegebene E-Mail befindet. Wenn leer, dann wird das Posteingang-Verzeichnis ausgewählt.
- Attachments$: Vollständiger Pfad zur Datei, die als Anhang hinzugefügt werden soll. Mehrere Anhänge können mit dem |-Zeichen getrennt werden.
- @ErrorOutput$: Falls ein Fehler auftritt, wird die Fehlermeldung in die String-Variable gespeichert.
- Rückgabewert:
- 1: Der Vorgang war erfolgreich.
- Syntax:
- MailEntryAttributeEx()
- Syntax:
Code: Alles auswählen
Result = MailEntryAttributeEx(ID, @ErrorOutput$)
- Beschreibung: Ermittelt den Status der E-Mail. Diese Funktion ist nur innerhalb der ExamineMailEx-Schleife gültig. Diese Funktion wird bei POP3 nicht unterstützt.
- Parameter:
- ID: Die Nummer der Verbindung.
- @ErrorOutput$: Falls ein Fehler auftritt, wird die Fehlermeldung in die String-Variable gespeichert.
- Rückgabewert: Folgende Konstanten können abgefragt werden:
- #PBEx_Mail_Attribute_Unseen: E-Mail wurde noch nicht gelesen.
- #PBEx_Mail_Attribute_Seen: E-Mail wurde bereits gelesen.
- Syntax:
- GetMailAttributeEx()
- Syntax:
Code: Alles auswählen
Result = GetMailAttributeEx(ID, MailID, DirectoryPath$, @ErrorOutput$)
- Beschreibung: Ermittelt mit Hilfe der MailID den Status der E-Mail. Diese Funktion wird bei POP3 nicht unterstützt.
- Parameter:
- ID: Die Nummer der Verbindung.
- MailID: Die Nummer der E-Mail.
- DirectoryPath$: Der Name oder vollständiger Pfad zum Verzeichnis, in dem sich die angegebene E-Mail befindet. Wenn leer, dann wird das Posteingang-Verzeichnis ausgewählt.
- @ErrorOutput$: Falls ein Fehler auftritt, wird die Fehlermeldung in die String-Variable gespeichert.
- Rückgabewert: Folgende Konstanten können abgefragt werden:
- #PBEx_Mail_Attribute_Unseen: E-Mail wurde noch nicht gelesen.
- #PBEx_Mail_Attribute_Seen: E-Mail wurde bereits gelesen.
- Syntax:
- SetMailAttributeEx()
- Syntax:
Code: Alles auswählen
Result = SetMailAttributeEx(ID, MailID, DirectoryPath$, Attributes, @ErrorOutput$)
- Beschreibung: Ändert mit Hilfe der MailID den Status der E-Mail. Diese Funktion wird bei POP3 nicht unterstützt.
- Parameter:
- ID: Die Nummer der Verbindung.
- MailID: Die Nummer der E-Mail.
- DirectoryPath$: Der Name oder vollständiger Pfad zum Verzeichnis, in dem sich die angegebene E-Mail befindet. Wenn leer, dann wird das Posteingang-Verzeichnis ausgewählt.
- Attributes: Folgende Konstanten können verwendet werden:
- #PBEx_Mail_Attribute_Unseen: E-Mail wurde noch nicht gelesen.
- #PBEx_Mail_Attribute_Seen: E-Mail wurde bereits gelesen.
- @ErrorOutput$: Falls ein Fehler auftritt, wird die Fehlermeldung in die String-Variable gespeichert.
- Rückgabewert:
- 1: Der Vorgang war erfolgreich.
- Syntax:
Je nach Anzahl der E-Mails in einem Verzeichnis und je nach Internetgeschwindigkeit kann es ggf. etwas dauern.
Systemvoraussetzungen:
- Windows Vista oder höher
- .NET Framework 4.8 oder höher
- Unicode-Aktivierung (standardmäßig ab PB 5.50)
Folgende Copyright-Texte müssen mitgeliefert werden:
Download: https://www.rsbasic.de/downloads/downlo ... x_Mail.zipCopyright (c) 2012-2014 Torben Könke
MimeKit is Copyright (C) 2012-2018 Xamarin Inc.
Copyright © 2019 RSBasic.de
Ich würde mich über Feedbacks, Verbesserungsvorschläge, Fehlermeldungen oder Wünsche sehr freuen. Wer mich unterstützen möchte, kann mir auch was kleines spenden. Danke