次の方法で共有

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

  • [アーティクル]

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

MAPIDetails 関数は、選択したアドレス一覧エントリの詳細を含むダイアログ ボックスを表示します。

構文

MAPIDETAILS Mapidetails;

ULONG Mapidetails(
  [in] LHANDLE lhSession,
  [in] ULONG_PTR ulUIParam,
  [in] lpMapiRecipDesc lpRecip,
  [in] FLAGS flFlags,
       ULONG ulReserved
)
{...}

パラメーター

[in] lhSession

単純な MAPI セッションまたは 0 を表すセッション ハンドル。 lhSession パラメーターの値が 0 の場合、MAPI はユーザーにログを記録し、呼び出しの期間中だけ存在するセッションを作成します。 この一時セッションには、既存の共有セッションまたは新しいセッションを指定できます。 ログオンを正常に完了するためにユーザーに追加情報が必要な場合は、ダイアログ ボックスが表示されます。

[in] ulUIParam

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

[in] lpRecip

詳細を表示する受信者へのポインター。 MAPIDetails は、ulEIDSize メンバーと lpEntryID メンバーを除き、この MapiRecipDesc 構造体のすべてのメンバーを無視します。 ulEIDSize の値が 0 以外の場合、MAPIDetails は受信者のエントリを解決します。 ulEIDSize の値が 0 の場合、MAPIDetails はMAPI_E_AMBIGUOUS_RECIP値を返します。

[in] flFlags

オプション フラグのビットマスク。 次のフラグを設定できます。

値 説明
MAPI_AB_NOMODIFY
呼び出し元は、ダイアログ ボックスを読み取り専用にすることを要求し、変更を禁止しています。 MAPIDetails は、要求を 受け入れているか、または受け入れません。
MAPI_LOGON_UI
必要に応じてログオンするようにユーザーに求めるダイアログ ボックスが表示されます。 MAPI_LOGON_UI フラグが設定されていない場合、クライアント アプリケーションはログオン ダイアログ ボックスを表示せず、ユーザーがログオンしていない場合はエラー値を返します。
MAPI_NEW_SESSION
環境の共有セッションを取得するのではなく、新しいセッションを作成する必要があります。 MAPI_NEW_SESSION フラグが設定されていない場合、 MAPIDetails は既存の共有セッションを使用します。

ulReserved

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

戻り値

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

リターン コード 説明
MAPI_E_AMBIGUOUS_RECIPIENT
lpRecips パラメーターが指す構造体の ulEIDSize メンバーが 0 であったため、ダイアログ ボックスを表示できませんでした。
MAPI_E_FAILURE
1 つ以上の未指定のエラーが発生しました。 ダイアログ ボックスが表示されませんでした。
MAPI_E_INSUFFICIENT_MEMORY
続行するメモリが不足していました。 ダイアログ ボックスが表示されませんでした。
MAPI_E_INVALID_RECIPS
lpRecip パラメーターで指定された受信者が不明であるか、受信者が無効な ulEIDSize 値を持っていました。 ダイアログ ボックスが表示されませんでした。
MAPI_E_LOGIN_FAILURE
既定のログオンがなく、ログオン ダイアログ ボックスが表示されたときにユーザーが正常にログオンできませんでした。 ダイアログ ボックスが表示されませんでした。
MAPI_E_NOT_SUPPORTED
操作は、基になるメッセージング システムでサポートされていませんでした。
MAPI_E_USER_ABORT
ユーザーがログオン ダイアログ ボックスまたは詳細ダイアログ ボックスを取り消しました。
SUCCESS_SUCCESS
呼び出しが成功し、詳細ダイアログ ボックスが表示されました。

解説

MAPIDetails 関数は、特定のアドレス一覧エントリの詳細を示すダイアログ ボックスを表示します。 表示名とアドレスは、ダイアログ ボックスに表示される最小属性です。詳細については、アドレス帳プロバイダーに応じて表示できます。 詳細ダイアログ ボックスを非表示にすることはできませんが、呼び出し元は読み取り専用または変更可能であることを要求できます。

詳細は、解決されたアドレス一覧エントリに対してのみ表示できます。 MapiRecipDesc 構造体の ulEIDSize メンバーの値が 0 以外の場合、エントリは解決されます。 エントリは、 MAPIAddress または MAPIResolveName 関数によって返され、結果として読み取りメールの受信者として解決されます。

必要条件

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

関連項目

MAPIAddress

MAPILogon

MAPIResolveName

MapiRecipDesc

簡易 MAPI