IAgent：：Load

[Microsoft 代理从 Windows 7 开始已弃用，可能在后续版本的 Windows 中不可用。]

HRESULT Load(
   VARIANT vLoadKey,  // data provider
   long * pdwCharID,  // address of a variable for character ID
   long * pdwReqID    // address of a variable for request ID
);

将字符加载到 Characters 集合中。

• 返回指示操作成功的S_OK。

vLoadKey

一个变体数据类型，必须是以下类型之一：

值	说明
filespec	指定字符的定义文件的本地文件位置。
URL	字符的定义文件的 HTTP 地址。

 

pdwCharID

接收字符 ID 的变量的地址。

pdwReqID

接收 加载 请求 ID 的变量的地址。

可以通过指定不包含冒号或前导斜杠字符) 的相对路径 (从 Microsoft 代理子目录加载字符。 这会将路径作为位于本地化 %windows%\msagent 目录) 中的代理字符目录 (的前缀。 还可以使用相对地址在代理的 Chars 目录中指定自己的目录。

不能 (具有相同 GUID 的字符从单个连接多次加载同一个字符) 。 同样，不能同时从单个连接加载默认字符和其他字符，因为默认字符可能与其他字符相同。 但是，可以使用 CoCreateInstance) 创建另一个连接 (并加载相同的字符。

Microsoft 代理的数据提供程序支持将存储为单个结构化文件的字符数据加载 (。ACS 将字符数据和动画数据一起) ，或作为单独的字符数据 (。ACF) 和动画 (。ACA) 文件。 通常，使用单个结构化 。ACS 文件，用于加载存储在本地磁盘驱动器或网络上并使用常规文件协议 (（例如 UNC 路径名) ）访问的字符。 使用单独的 。ACF 和 。如果要从使用 HTTP 协议访问动画文件的远程站点单独加载动画文件，则 ACA 文件。

对于 。ACS 文件，使用 Load 方法提供对角色动画的访问;加载后，可以使用 Play 方法对角色进行动画处理。 对于 。ACF 文件，还可以使用 Prepare 方法来加载动画数据。 Load 方法不支持下载 。来自 HTTP 站点的 ACS 文件。

加载字符不会自动显示该字符。 首先使用 Show 方法使字符可见。