IAgent::Load

[Microsoft Agent è deprecato a partire da Windows 7 e potrebbe non essere disponibile nelle versioni successive di 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
);

Carica un carattere nell'insieme Characters .

• Restituisce S_OK per indicare che l'operazione è riuscita.

vLoadKey

Tipo di dati variant che deve essere uno dei seguenti:

Valore	Descrizione
filespec	Percorso del file locale del file di definizione del carattere specificato.
URL	Indirizzo HTTP per il file di definizione del carattere.

 

pdwCharID

Indirizzo di una variabile che riceve l'ID del carattere.

pdwReqID

Indirizzo di una variabile che riceve l'ID richiesta di caricamento .

È possibile caricare i caratteri dalla sottodirectory di Microsoft Agent specificando un percorso relativo (uno che non include due punti o un carattere barra iniziale). In questo modo il percorso viene preceduto dalla directory dei caratteri dell'agente , che si trova nella directory %windows%\msagent localizzata. È anche possibile usare un indirizzo relativo per specificare la propria directory nella directory Chars di Agent.

Non è possibile caricare lo stesso carattere (un carattere con lo stesso GUID) più volte da una singola connessione. Analogamente, non è possibile caricare il carattere predefinito e altri caratteri contemporaneamente da una singola connessione, perché il carattere predefinito potrebbe essere uguale all'altro carattere. Tuttavia, è possibile creare un'altra connessione (usando CoCreateInstance) e caricare lo stesso carattere.

Il provider di dati di Microsoft Agent supporta il caricamento di dati di tipo carattere archiviati come un singolo file strutturato (. ACS) con dati di tipo carattere e dati di animazione insieme o come dati di tipo carattere separati (. ACF) e animazione (. File ACA). In genere, usare il singolo oggetto strutturato. File ACS per caricare un carattere archiviato in un'unità disco locale o in una rete e a cui si accede usando il protocollo di file convenzionale ,ad esempio i nomi di percorso UNC. Usare l'oggetto separato. ACF e . File ACA quando si desidera caricare i file di animazione singolarmente da un sito remoto a cui si accede usando il protocollo HTTP.

Per. I file ACS, usando il metodo Load consentono di accedere alle animazioni di un carattere; dopo il caricamento, è possibile usare il metodo Play per animare il carattere. Per. I file ACF usano anche il metodo Prepare per caricare i dati di animazione. Il metodo Load non supporta il download di . File ACS da un sito HTTP.

Il caricamento di un carattere non visualizza automaticamente il carattere. Utilizzare prima il metodo Show per rendere visibile il carattere.