Session 对象 (CDONTS Library)

Session 对象包含会话期内的设置和选项。

速查

声明所在的类型库：	CDONTS.DLL
首次启用：	CDO for NTS Library 版本 1.2
父对象：	（无）
子对象：	Folder
默认属性：	Name

属性

名	首次启用版本	类型	访问
Application	1.2	字符串	只读
Class	1.2	长整型	只读
Inbox	1.2	Folder 对象	只读
MessageFormat	1.2	长整型	可读写
Name	1.2	字符串	只读
Outbox	1.2	Folder 对象	只读
Parent	1.2	对象；设置为 Nothing	只读
Session	1.2	Session 对象（自身）	只读
Version	1.2	字符串	只读

方法

Name	首次启用版本	参数


GetDefaultFolder	1.2	folderType as Long

Logoff	1.2	（无）
LogonSMTP	1.2	DisplayName as String, Address as String
SetLocaleIDs	1.2	CodePageID as Long

注释

Session 对象是最顶层的对象，也就是说，它可以直接从 Microsoft® Visual Basic® 程序中创建。在 CDO for NTS Library 中，它有一个 CDONTS.Session ProgID。下面这段代码在事先绑定的情况下创建 Session 对象：

Dim objSession As CDONTS.Session 
Set objSession = CreateObject ("CDONTS.Session") 
objSession.LogonSMTP

下面这段代码在未绑定的情况下创建 Session 对象：

Dim objSession As Object 
Set objSession = CreateObject ("CDONTS.Session") 
objSession.LogonSMTP

通常，事先绑定比较好，因为这样会强制类型检查，而且生成的代码效率较高。请注意，为了将 CDO 应用程序与通过其他对象库用于 Visual Basic 程序的应用程序区分开来，必须指定完整的 ProgID "CDONTS.Session"，不要只指定 "Session"。

在两种情况下，当创建了新的 Session 对象之后，必须调用该对象的 LogonSMTP 方法对其初始化。在未成功调用 LogonSMTP 之前，不允许 CDO for NTS Library 的任何其他活动。唯一的例外就是 Session 对象的 SetLocaleIDs 方法。