共用方式為


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

必須是下列其中一項的 Variant 資料類型:

價值 描述
filespec 指定字元定義檔的本機檔案位置。
URL 字元定義檔的 HTTP 位址。

 

pdwCharID

接收字元識別碼的變數位址。

pdwReqID

接收 載入 要求標識子的變數位址。

您可以藉由指定相對路徑(不包含冒號或前置斜線字元),從 Microsoft Agent 子目錄載入字元。 這會在路徑前面加上 Agent 的字元目錄(位於當地語系化 %windows%\msagent 目錄)。 您也可以使用相對位址在 Agent 的 Chars 目錄中指定自己的目錄。

您無法從單一連線多次載入相同字元(具有相同 GUID 的字元)。 同樣地,您無法從單一連接同時載入預設字元和其他字元,因為預設字元可能與其他字元相同。 不過,您可以建立另一個連線(使用 CoCreateInstance)並載入相同的字元。

Microsoft Agent 的數據提供者支援載入儲存為單一結構化檔案的字元數據。ACS 包含字元數據和動畫數據,或做為個別字元數據(。ACF) 和動畫 (.ACA) 檔案。 一般而言,使用單一結構化 。ACS 檔案以載入儲存在本機磁碟驅動器或網路上的字元,並使用傳統檔案通訊協定存取(例如 UNC 路徑名稱)。 使用個別的 。ACF 和 。當您想要從使用 HTTP 通訊協定存取動畫檔案的遠端月臺個別載入動畫檔案時,ACA 檔案。

為。ACS 檔案,使用 Load 方法來提供字元動畫的存取;載入之後,您可以使用 Play 方法來建立字元的動畫效果。 為。ACF 檔案,您也可以使用 Prepare 方法來載入動畫數據。 Load 方法不支援下載 。來自 HTTP 網站的 ACS 檔案。

載入字元不會自動顯示字元。 請先使用 Show 方法讓字元顯示。