_NameSpace.Logon(Object, Object, Object, Object) メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
ユーザーを MAPI にログオンさせ、MAPI セッションを返します。
public void Logon (object Profile, object Password, object ShowDialog, object NewSession);Public Sub Logon (Optional Profile As Object, Optional Password As Object, Optional ShowDialog As Object, Optional NewSession As Object)パラメーター
- Profile
- Object
セッションに使用する 文字列 (C#の文字列 ) としての MAPI プロファイル名。 現在のセッションの既定のプロファイルを使用するには、空の文字列を指定します。
- Password
- Object
プロファイルに関連付けられている 文字列 (C#の文字列 ) としてのパスワード (存在する場合)。 このパラメーターは下位互換性のためにのみ存在し、セキュリティ上の理由から、使用することはお勧めしません。 Microsoft Outlook は、ほとんどのシステム構成でパスワードを指定するようにユーザーに求めます。 これはログオン パスワードであり、PST パスワードと混同しないでください。
- ShowDialog
- Object
True を指定すると、MAPI のログオン ダイアログ ボックスが表示され、ユーザーが MAPI プロファイルを選択できます。
- NewSession
- Object
True を 指定すると、新しい Outlook セッションが作成されます。 Outlook では複数のセッションを作成できないため、セッションがまだ存在しない場合にのみ、このパラメーターを True として指定する必要があります。
注釈
まだ Outlook を実行していない場合、 Logon メソッドのみを使用して特定のプロファイルにログオンします。 これは、一度に 1 つの Outlook プロセスしか実行できず、Outlook プロセスは 1 つのプロファイルのみを使用し、1 つの MAPI セッションのみをサポートしているためです。 ユーザーが Outlook を 2 回目に起動すると、その Outlook のインスタンスは同じ Outlook プロセス内で実行され、新しいプロセスは作成されず、同じプロファイルが使用されます。
既に Outlook を実行している場合、このメソッドを使用して新しい Outlook セッションを作成したり、現在のプロファイルを別のプロファイルに変更したりすることはできません。
Outlook が実行されておらず、既定のプロファイルでのみ Outlook を起動する場合は、 Logon メソッドを使用しないでください。 次のコード例 InitializeMAPI には、より適切な方法が示されています。最初に Outlook Application オブジェクトをインスタンス化してから、受信トレイなどの既定のフォルダーを参照します。 これは、MAPI を初期化して既定のプロファイルを使用し、オブジェクト モデルを完全に機能させる副作用があります。
Imports Outlook = Microsoft.Office.Interop.Outlook
Sub InitializeMAPI ()
' Start Outlook.
Dim olApp As Outlook.Application
Set olApp = CreateObject("Outlook.Application")
' Get a session object.
Dim olNs As Outlook.NameSpace
Set olNs = olApp.GetNamespace("MAPI")
' Create an instance of the Inbox folder.
' If Outlook is not already running, this has the side
' effect of initializing MAPI.
Dim mailFolder As Outlook.Folder
Set mailFolder = olNs.GetDefaultFolder(olFolderInbox)
' Continue to use the object model to automate Outlook.
End Sub
Outlook 2010 以降では、複数のプロファイルがある場合は、常に既定のプロファイルを使用するように Outlook を構成し、 Logon メソッドを使用してユーザーにプロンプトを表示せずに既定のプロファイルにログオンすると、ユーザーはプロファイルを選択するように求めるプロンプトを受け取ります。 こうした動作を回避するため、Logon メソッドを使用せずに、前述の InitializeMAPI の例で示した回避策を実行してください。