IAgent::Load

[Microsoft Agent está en desuso a partir de Windows 7 y puede no estar disponible en versiones posteriores de 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
);

Carga un carácter en la colección Characters .

• Devuelve S_OK para indicar que la operación se realizó correctamente.

vLoadKey

Un tipo de datos variant que debe ser uno de los siguientes:

Value	Descripción
filespec	Ubicación del archivo local del archivo de definición del carácter especificado.
URL	Dirección HTTP del archivo de definición del carácter.

 

pdwCharID

Dirección de una variable que recibe el identificador del carácter.

pdwReqID

Dirección de una variable que recibe el identificador de solicitud de carga .

Puede cargar caracteres desde el subdirectorio de Microsoft Agent especificando una ruta de acceso relativa (una que no incluya un carácter de dos puntos o barra diagonal inicial). Este prefijo la ruta de acceso con el directorio de caracteres del Agente (ubicado en el directorio %windows%\msagent localizado). También puede usar una dirección relativa para especificar su propio directorio en el directorio Chars del agente.

No se puede cargar el mismo carácter (un carácter que tenga el mismo GUID) más de una vez desde una sola conexión. Del mismo modo, no se puede cargar el carácter predeterminado y otros caracteres al mismo tiempo desde una sola conexión, ya que el carácter predeterminado podría ser el mismo que el otro carácter. Sin embargo, puede crear otra conexión (mediante CoCreateInstance) y cargar el mismo carácter.

El proveedor de datos de Microsoft Agent admite la carga de datos de caracteres almacenados como un único archivo estructurado (. ACS) con datos de caracteres y datos de animación juntos, o como datos de caracteres independientes (. ACF) y animación (. ACA) archivos. Por lo general, use el único estructurado. Archivo ACS para cargar un carácter que se almacena en una unidad de disco local o en una red y a los que se accede mediante el protocolo de archivo convencional (como los nombres de ruta de acceso UNC). Use la propiedad independiente . ACF y . Archivos ACA cuando quiera cargar los archivos de animación individualmente desde un sitio remoto al que se accede mediante el protocolo HTTP.

Para. Los archivos ACS, mediante el método Load proporcionan acceso a las animaciones de un carácter; Una vez cargado, puede usar el método Play para animar el carácter. Para. Los archivos ACF también se usan el método Prepare para cargar datos de animación. El método Load no admite la descarga de . Archivos ACS de un sitio HTTP.

La carga de un carácter no muestra automáticamente el carácter. Use primero el método Show para que el carácter sea visible.