指定されたユーザーのメールデータを返します。

メモ このメソッドは Release 8 で新しく追加されました。

定義位置

NotesDirectory

構文

mailinfo = notesDirectory.GetMailInfo(username [, getver] [, errorOnMultipleMatches])

パラメータ

username

String 型。メール情報が要求されたユーザー名です。

省略可能。Boolean 型。ユーザーのホームメールサーバーのビルド番号とバージョン情報を要求するフラグです。デフォルト値は False です。

省略可能。Boolean 型。username の複数一致の処理方法を示すフラグです。この引数が True の場合、複数一致があるとエラーコードが生成されます。この引数が False の場合、複数一致がある場合に最初の一致が使用されます。デフォルト値は True です。

mailinfo

String 型の配列を含む Variant。指定されたユーザーのメールデータです。返される要素は次の通りです。
• Mail Server - 指定されたユーザーのホームメールサーバーです。
• BuildNumber - getver が True の場合、指定されたユーザーのメールサーバーのビルド番号の文字列表記 (たとえば、"303") です。getver が False の場合、"" です。
• DominoVersion - getver が True の場合、指定されたユーザーのメールサーバーの Lotus Domino バージョンの文字列表記 (たとえば、"Build V80_07042006NP")。getver が False の場合、"" です。
• MailFile - 指定されたユーザーのメールファイルです。
• ShortName - 指定されたユーザーの名前の短縮形です。
• MailDomain - 指定されたユーザーのメールアドレスの Lotus Notes ドメインです。
• User Name - 指定されたユーザーに付与されたユーザー名リストの最初のエントリです。
• InternetMailAddress - 指定されたユーザーのインターネットメールアドレスです。
• OutOfOffice - 不在通知のサービスタイプです。「1」はエージェントを示し、「2」はサービスを示します。

メール情報のディレクトリ検索では、Directory クラスのインスタンスで指定された常駐サーバーが使用されます (存在する場合)。この方法がうまくいかない場合は、ユーザーの現在のオペレーティング環境からこのメソッドに関するブートストラップ情報が収集されます。

errorOnMultipleMatches が True で、同じ名前に対して複数一致が見つかった場合、スローされるエラーコードはエラーコード 4751「ディレクトリにこのユーザーの複数のエントリが含まれています」です。

検索要求に応答するサーバーがない場合、スローされるエラーコードはエラーコード 4749「サーバーにアクセスできません」です。

username がディレクトリ内で見つからなかった場合、スローされるエラーコードはエラーコード 4731「ユーザーがディレクトリに見つかりません」です。

その他の理由でメソッドが失敗した場合、スローされるエラーコードはエラーコード 4730「GetMailInfo が失敗しました」です。

getver が True で、指定されたユーザーのホームサーバーが使用できない場合、BuildNumber と DominoVersion は空欄になります。

例

用語集