Outlook) (NameSpace.Logon 方法

讓使用者登入 MAPI,取得 MAPI 作業階段。

語法

運算式。 Logon( _Profile_ , _Password_ , _ShowDialog_ , _NewSession_ )

運算式 代表 NameSpace 物件的變數。

參數

名稱 必要/選用 資料類型 描述
設定檔 選用 Variant MAPI 設定檔的名稱 (如 String) 用於作業階段。 指定空白字串,以便在目前作業階段中使用預設設定檔。
Password 選用 Variant 密碼 (如果有的話),如同 String,與設定檔相關。 此參數僅出於回溯相容性和安全性考量而存在,不建議使用。 在大部分的系統設定中,Microsoft Outlook 會提示使用者指定密碼。 這是您的登入密碼,請勿與 PST 密碼混淆。
ShowDialog 選用 Variant True 會顯示 MAPI 登入對話方塊,可讓使用者選取 MAPI 設定檔。
NewSession 選用 Variant True,建立新的 Microsoft Outlook 工作階段。 由於在 Outlook 中無法建立多個作業階段,因此只有當作業階段已經不存在時,才將這個參數指定為 True。

註解

僅在 Outlook 尚未執行時,使用 登入 方法登入特定設定檔。 這是因為一次只能執行一個 Outlook 程序,而該 Outlook 程序只會使用一個設定檔,且只支援一個 MAPI 工作階段。 當使用者第二次啟動 Outlook 時,該 Outlook 執行個體會在相同的 Outlook 處理程序內執行,不會建立新處理程序,而是使用相同的設定檔。

如果 Outlook 已在執行中,使用此方法不會建立新的 Outlook 工作階段或將目前的設定檔變更為不同的工作階段。

如果 Outlook 未執行,而您只想使用預設設定檔啟動 Outlook,請勿使用 登入 方法。 下列程式碼範例顯示了更好的替代方案: InitializeMAPI首先,具現化 Outlook 應用程式 物件,然後參考預設資料夾,例如收件匣。 這會產生初始化 MAPI 以使用預設設定檔的副作用,並讓物件模型完全正常運作。

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 方法;請改用上述 InitializeMAPI 範例中建議的因應措施。

範例

此 Visual Basic for Applications 範例使用 Logon 方法登入新工作階段,顯示驗證設定檔名稱和輸入密碼的對話方塊。

Sub StartOutlook() 
    Dim myNameSpace As Outlook.NameSpace 
  
    Set myNameSpace = Application.GetNamespace("MAPI") 
    myNameSpace.Logon "LatestProfile", , True, True 
End Sub

另請參閱

命名空間物件

如何:取得並登入 Outlook 執行個體

支援和意見反應

有關於 Office VBA 或這份文件的問題或意見反應嗎? 如需取得支援服務並提供意見反應的相關指導,請參閱 Office VBA 支援與意見反應。