GetMailInfo (NotesDirectory - LotusScript®)

定義位置

NotesDirectory

構文

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

パラメータ

username

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

getver

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

errorOnMultipleMatches

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

戻り値

mailinfo

String 型の配列を含む Variant。指定されたユーザーのメールデータです。返される要素は次の通りです。

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

使用法

メール情報のディレクトリ検索では、Directory クラスのインスタンスで指定された常駐サーバーが使用されます (存在する場合)。これが失敗すると、メソッドのブートストラップ情報が、ユーザーの現在の操作環境から収集されます。

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

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

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

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

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

例