[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 方法讓字元顯示。