Поделиться через

IAgent::Load

  • Статья

[Агент Майкрософт не рекомендуется использовать в 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
);

Загружает символ в коллекцию Символы .

  • Возвращает S_OK для указания успешной операции.

vLoadKey

Вариантный тип данных, который должен быть одним из следующих:

Значение Описание
filespec Расположение локального файла определения указанного символа.
URL-адрес HTTP-адрес для файла определения символа.

 

pdwCharID

Адрес переменной, получающей идентификатор символа.

pdwReqID

Адрес переменной, получающей идентификатор запроса загрузки .

Вы можете загрузить символы из подкаталога Microsoft Agent, указав относительный путь (который не содержит двоеточие или символ косой черты). Это префикс пути с каталогом символов агента (расположенным в локализованном каталоге %windows%\msagent). Вы также можете использовать относительный адрес, чтобы указать собственный каталог в каталоге Chars агента.

Вы не можете загрузить один и тот же символ (символ с одним и тем же ИДЕНТИФИКАТОРом GUID) несколько раз из одного соединения. Аналогичным образом нельзя одновременно загрузить символ по умолчанию и другие символы из одного соединения, так как символ по умолчанию может быть таким же, как и другой символ. Однако можно создать другое соединение (с помощью CoCreateInstance) и загрузить тот же символ.

Поставщик данных Microsoft Agent поддерживает загрузку символьных данных, хранящихся в виде одного структурированного файла (. ACS) с символьными данными и данными анимации вместе или в виде отдельных символьных данных (. ACF) и анимация (. Файлы ACA). Как правило, используйте один структурированный объект . Файл ACS для загрузки символа, хранящегося на локальном диске или в сети и доступ к которому осуществляется по обычному протоколу файлов (например, UNC-имена путей). Используйте отдельный . ACF и . Файлы ACA, если требуется загрузить файлы анимации по отдельности с удаленного сайта, где к них можно получить доступ по протоколу HTTP.

Для. Файлы ACS с помощью метода Load предоставляют доступ к анимациям символов; После загрузки можно использовать метод Play для анимации символа. Для. Файлы ACF также используют метод Prepare для загрузки данных анимации. Метод Load не поддерживает скачивание . Файлы ACS с сайта HTTP.

При загрузке символа он не отображается автоматически. Сначала используйте метод Show , чтобы сделать символ видимым.