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
オプション フラグのビットマスク。 次のフラグを設定できます。
ulReserved
予約;は 0 である必要があります。
戻り値
この関数は、次のいずれかの値を返します。
リターン コード | 説明 |
---|---|
|
lpRecips パラメーターが指す構造体の ulEIDSize メンバーが 0 であったため、ダイアログ ボックスを表示できませんでした。 |
|
1 つ以上の未指定のエラーが発生しました。 ダイアログ ボックスが表示されませんでした。 |
|
続行するメモリが不足していました。 ダイアログ ボックスが表示されませんでした。 |
|
lpRecip パラメーターで指定された受信者が不明であるか、受信者が無効な ulEIDSize 値を持っていました。 ダイアログ ボックスが表示されませんでした。 |
|
既定のログオンがなく、ログオン ダイアログ ボックスが表示されたときにユーザーが正常にログオンできませんでした。 ダイアログ ボックスが表示されませんでした。 |
|
操作は、基になるメッセージング システムでサポートされていませんでした。 |
|
ユーザーがログオン ダイアログ ボックスまたは詳細ダイアログ ボックスを取り消しました。 |
|
呼び出しが成功し、詳細ダイアログ ボックスが表示されました。 |
解説
MAPIDetails 関数は、特定のアドレス一覧エントリの詳細を示すダイアログ ボックスを表示します。 表示名とアドレスは、ダイアログ ボックスに表示される最小属性です。詳細については、アドレス帳プロバイダーに応じて表示できます。 詳細ダイアログ ボックスを非表示にすることはできませんが、呼び出し元は読み取り専用または変更可能であることを要求できます。
詳細は、解決されたアドレス一覧エントリに対してのみ表示できます。 MapiRecipDesc 構造体の ulEIDSize メンバーの値が 0 以外の場合、エントリは解決されます。 エントリは、 MAPIAddress または MAPIResolveName 関数によって返され、結果として読み取りメールの受信者として解決されます。
必要条件
対象プラットフォーム | Windows |
ヘッダー | mapi.h |