MAPISENDDOCUMENTS-Rückruffunktion (mapi.h)

[Die Verwendung dieser Funktion wird abgeraten. Sie kann in nachfolgenden Versionen von Windows geändert oder nicht verfügbar sein.]

Die MAPISendDocuments-Funktion sendet eine Standardnachricht mit einer oder mehreren angefügten Dateien und einer Decknotiz. Die Decknotiz ist ein Dialogfeld, in dem der Benutzer eine Liste von Empfängern und eine optionale Nachricht eingeben kann. MAPISendDocuments unterscheidet sich von der MAPISendMail-Funktion darin, dass sie weniger Flexibilität bei der Nachrichtengenerierung ermöglicht.

Syntax

MAPISENDDOCUMENTS Mapisenddocuments;

ULONG Mapisenddocuments(
  [in] ULONG_PTR ulUIParam,
  [in] LPSTR lpszDelimChar,
  [in] LPSTR lpszFilePaths,
  [in] LPSTR lpszFileNames,
       ULONG ulReserved
)
{...}

Parameter

[in] ulUIParam

Ziehpunkt des übergeordneten Fensters oder null, was angibt, dass es sich bei der Anzeige eines Dialogfelds um eine modale Anwendung handelt. Wenn der ulUIParam-Parameter ein übergeordnetes Fensterhandle enthält, ist er vom Typ HWND (in eine ULONG_PTR umgewandelt). Wenn während des Aufrufs kein Dialogfeld angezeigt wird, wird ulUIParam ignoriert.

[in] lpszDelimChar

Zeiger auf ein Zeichen, das der Aufrufer verwendet, um die Namen zu trennen, auf die durch die Parameter lpszFullPaths und lpszFileNames verwiesen wird . Der Aufrufer sollte ein Zeichen für das Trennzeichen auswählen, das nicht in Betriebssystemdateinamen verwendet wird.

[in] lpszFilePaths

Zeiger auf eine Zeichenfolge, die eine Liste vollständiger Pfade (einschließlich Laufwerkbuchstaben) zu Anlagendateien enthält. Diese Liste wird durch Verketten korrekt formatierter Dateipfade gebildet, die durch das im lpszDelimChar-Parameter angegebene Zeichen und gefolgt von einem NULL-Abschlusszeichen getrennt sind. Ein Beispiel für eine gültige Liste ist:

C:\TMP\TEMP1.DOC;C:\TMP\TEMP2.DOC

Die in diesem Parameter angegebenen Dateien werden der Nachricht als Dateianlagen hinzugefügt. Wenn dieser Parameter NULL ist oder eine leere Zeichenfolge enthält, wird das Dialogfeld Notiz senden ohne angefügte Dateien angezeigt.

[in] lpszFileNames

Zeiger auf eine NULL-beendete Liste der ursprünglichen Dateinamen, wie sie in der Nachricht angezeigt werden sollen. Wenn mehrere Namen angegeben werden, wird die Liste gebildet, indem die Dateinamen getrennt durch das im lpszDelimChar-Parameter angegebene Zeichen und gefolgt von einem NULL-Abschlusszeichen verkettet werden. Im folgenden Code wird ein Beispiel veranschaulicht:

TEMP3.DOC;TEMP4.DOC

Wenn kein Wert für den parameter lpszFileNames vorhanden ist oder wenn er leer ist, legt MAPISendDocuments die Dateinamen fest, die auf die Dateinamenwerte festgelegt sind, die durch den lpszFullPaths-Parameter angegeben werden.

ulReserved

Reserviert; muss null sein.

Rückgabewert

Diese Funktion gibt einen der folgenden Werte zurück.

Rückgabecode	Beschreibung
MAPI_E_ATTACHMENT_OPEN_FAILURE	Mindestens eine Datei im lpszFilePaths-Parameter konnte nicht gefunden werden. Es wurde keine Nachricht gesendet.
MAPI_E_ATTACHMENT_WRITE_FAILURE	Eine Anlage konnte nicht in eine temporäre Datei geschrieben werden. Überprüfen Sie die Verzeichnisberechtigungen.
MAPI_E_FAILURE	Mindestens ein nicht angegebener Fehler ist beim Senden der Nachricht aufgetreten. Es ist nicht bekannt, ob die Nachricht gesendet wurde.
MAPI_E_INSUFFICIENT_MEMORY	Es war nicht genügend Arbeitsspeicher vorhanden, um fortzufahren.
MAPI_E_LOGIN_FAILURE	Es gab keine Standardanmeldung, und der Benutzer konnte sich nicht erfolgreich anmelden, wenn das Anmeldedialogfeld angezeigt wurde. Es wurde keine Nachricht gesendet.
MAPI_E_USER_ABORT	Der Benutzer hat eines der Dialogfelder abgebrochen. Es wurde keine Nachricht gesendet.
SUCCESS_SUCCESS	Der Aufruf war erfolgreich, und die Nachricht wurde gesendet.

Hinweise

Die MAPISendDocuments-Funktion sendet eine Standardnachricht, wobei immer ein Decknotizdialogfeld angezeigt wird, damit der Benutzer Empfänger und andere Sendeoptionen angeben kann. Diese Funktion versucht, mithilfe der freigegebenen Sitzung des Messagingsystems eine Sitzung einzurichten. Wenn keine freigegebene Sitzung vorhanden ist, wird der Benutzer aufgefordert, Anmeldeinformationen einzugeben, um eine Sitzung einzurichten. Bevor MAPISendDocuments zurückgibt, wird die Sitzung beendet.

Nachrichtenanlagen können das aktive Dokument oder alle derzeit geöffneten Dokumente in der Clientanwendung enthalten, die MAPISendDocuments aufgerufen hat. Diese Funktion wird hauptsächlich für Aufrufe aus einer Makro- oder Skriptsprache verwendet, die häufig in Anwendungen wie Tabellenkalkulationen oder Textverarbeitungsprogrammen zu finden sind.

MAPISendDocuments erstellt so viele Dateianlagen, wie vom lpszFullPaths-Parameter angegebene Pfade vorhanden sind, obwohl die Anzahl der Pfade und Dateinamen unterschiedlich sein kann. Der Aufrufer ist für das Löschen temporärer Dateien verantwortlich, die bei verwendung von MAPISendDocuments erstellt wurden.

Anforderungen

Anforderung	Wert
Zielplattform	Windows
Kopfzeile	mapi.h

Weitere Informationen

MAPISendMail

Einfache MAPI