MAPISENDDOCUMENTS コールバック関数 (mapi.h)

[この関数の使用はお勧めしません。 以降のバージョンの Windows では変更または使用できない場合があります。]

MAPISendDocuments 関数は、1 つ以上の添付ファイルとカバー ノートを含む標準メッセージを送信します。 カバー ノートは、ユーザーが受信者の一覧とオプションのメッセージを入力できるようにするダイアログ ボックスです。 MAPISendDocuments は、メッセージ生成の柔軟性が低い 点で MAPISendMail 関数とは異なります。

構文

MAPISENDDOCUMENTS Mapisenddocuments;

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

パラメーター

[in] ulUIParam

ダイアログ ボックスが表示されている場合は、アプリケーション モーダルであることを示す親ウィンドウ ハンドルまたはゼロ。 ulUIParam パラメーターに親ウィンドウ ハンドルが含まれている場合は、HWND 型です (ULONG_PTRにキャストされます)。 呼び出し中にダイアログ ボックスが表示されない場合、 ulUIParam は無視されます。

[in] lpszDelimChar

lpszFullPaths パラメーターと lpszFileNames パラメーターが指す名前を区切るために呼び出し元が使用する文字へのポインター。 呼び出し元は、オペレーティング システムのファイル名で使用されない区切り記号の文字を選択する必要があります。

[in] lpszFilePaths

添付ファイルへの完全なパス (ドライブ文字を含む) の一覧を含む文字列へのポインター。 このリストは、 lpszDelimChar パラメーターで指定された文字で区切られた正しい形式のファイル パスを連結し、その後に null ターミネータを続けることで形成されます。 有効なリストの例を次に示します。

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

このパラメーターで指定されたファイルは、添付ファイルとしてメッセージに追加されます。 このパラメーターが NULL であるか、空の文字列が含まれている場合は、[メモの送信] ダイアログ ボックスが添付ファイルなしで表示されます。

[in] lpszFileNames

メッセージに表示される元のファイル名の null で終わるリストへのポインター。 複数の名前を指定すると、 lpszDelimChar パラメーターで指定された文字で区切られたファイル名を連結し、その後に null ターミネータを続けることで、リストが形成されます。 例を示します。

TEMP3.DOC;TEMP4.DOC

lpszFileNames パラメーターの値がない場合、または空の場合、MAPISendDocuments は lpszFullPaths パラメーターで示されるファイル名の値に設定されたファイル名を設定します。

ulReserved

予約;は 0 である必要があります。

戻り値

この関数は、次のいずれかの値を返します。

リターン コード 説明
MAPI_E_ATTACHMENT_OPEN_FAILURE
lpszFilePaths パラメーター内の 1 つ以上のファイルが見つかりませんでした。 メッセージが送信されませんでした。
MAPI_E_ATTACHMENT_WRITE_FAILURE
添付ファイルを一時ファイルに書き込めませんでした。 ディレクトリのアクセス許可を確認します。
MAPI_E_FAILURE
メッセージの送信中に、1 つ以上の未指定のエラーが発生しました。 メッセージが送信されたかどうかは不明です。
MAPI_E_INSUFFICIENT_MEMORY
続行するメモリが不足していました。
MAPI_E_LOGIN_FAILURE
既定のログオンがなく、ログオン ダイアログ ボックスが表示されたときにユーザーが正常にログオンできませんでした。 メッセージが送信されませんでした。
MAPI_E_USER_ABORT
ユーザーがいずれかのダイアログ ボックスを取り消しました。 メッセージが送信されませんでした。
SUCCESS_SUCCESS
呼び出しが成功し、メッセージが送信されました。

注釈

MAPISendDocuments 関数は標準メッセージを送信し、ユーザーが受信者やその他の送信オプションを指定できるように、常にカバー ノート ダイアログ ボックスを表示します。 この関数は、メッセージング システムの共有セッションを使用してセッションの確立を試みます。 共有セッションが存在しない場合は、セッションを確立するためのログオン情報をユーザーに求めます。 MAPISendDocuments が返される前に、セッションが終了します。

メッセージの添付ファイルには、 MAPISendDocuments を呼び出したクライアント アプリケーション内の作業中の文書または現在開いているすべてのドキュメントを含めることができます。 この関数は、主にマクロまたはスクリプト言語からの呼び出しに使用されます。多くの場合、スプレッドシートやワープロ プログラムなどのアプリケーションで使用されます。

MAPISendDocuments は、 lpszFullPaths パラメーターで指定されたパスと同じ数の添付ファイルを作成しますが、パスとファイル名の数が異なる可能性があります。 呼び出し元は、 MAPISendDocuments を使用するときに作成された一時ファイルを削除する必要があります。

要件

要件 値
対象プラットフォーム Windows
ヘッダー mapi.h

こちらもご覧ください

MAPISendMail

簡易 MAPI

  • Last updated on