IAgent::Load

[Microsoft Agent tidak digunakan lagi pada Windows 7, dan mungkin tidak tersedia dalam versi Windows berikutnya.]

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

Memuat karakter ke dalam koleksi Karakter .

• Mengembalikan S_OK untuk menunjukkan operasi berhasil.

vLoadKey

Jenis data varian yang harus merupakan salah satu dari berikut ini:

Nilai	Deskripsi
Filespec	Lokasi file lokal dari file definisi karakter yang ditentukan.
URL	Alamat HTTP untuk file definisi karakter.

 

pdwCharID

Alamat variabel yang menerima ID karakter.

pdwReqID

Alamat variabel yang menerima ID permintaan Muat .

Anda dapat memuat karakter dari subdirektori Agen Microsoft dengan menentukan jalur relatif (yang tidak menyertakan karakter garis miring atau titik dua di depannya). Ini mengawali jalur dengan direktori karakter Agen (terletak di direktori %windows%\msagent yang dilokalkan). Anda juga dapat menggunakan alamat relatif untuk menentukan direktori Anda sendiri di direktori Chars Agen.

Anda tidak dapat memuat karakter yang sama (karakter yang memiliki GUID yang sama) lebih dari sekali dari satu koneksi. Demikian pula, Anda tidak dapat memuat karakter default dan karakter lain secara bersamaan dari satu koneksi, karena karakter default bisa sama dengan karakter lainnya. Namun, Anda dapat membuat koneksi lain (menggunakan CoCreateInstance) dan memuat karakter yang sama.

Penyedia data Agen Microsoft mendukung pemuatan data karakter yang disimpan sebagai satu file terstruktur (. ACS) dengan data karakter dan data animasi bersama-sama, atau sebagai data karakter terpisah (. ACF) dan animasi (. ACA) file. Umumnya, gunakan satu terstruktur . File ACS untuk memuat karakter yang disimpan di drive disk atau jaringan lokal dan diakses menggunakan protokol file konvensional (seperti nama jalur UNC). Gunakan terpisah . ACF dan . File ACA ketika Anda ingin memuat file animasi satu per satu dari situs jarak jauh tempat file tersebut diakses menggunakan protokol HTTP.

Untuk. File ACS, menggunakan metode Muat menyediakan akses animasi karakter; setelah dimuat, Anda dapat menggunakan metode Putar untuk menganimasikan karakter. Untuk. File ACF, Anda juga menggunakan metode Siapkan untuk memuat data animasi. Metode Muat tidak mendukung pengunduhan . File ACS dari situs HTTP.

Memuat karakter tidak secara otomatis menampilkan karakter. Gunakan metode Tampilkan terlebih dahulu untuk membuat karakter terlihat.