IAgent::Load

[Der Microsoft-Agent ist ab Windows 7 veraltet und kann in nachfolgenden Versionen von Windows nicht verfügbar sein.]

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

Lädt ein Zeichen in die Characters -Auflistung.

• Gibt S_OK zurück, um anzugeben, dass der Vorgang erfolgreich war.

vLoadKey-

Ein Variant-Datentyp, der eine der folgenden Sein muss:

Wert	Beschreibung
filespec	Der lokale Dateispeicherort der Definitionsdatei des angegebenen Zeichens.
URL-	Die HTTP-Adresse für die Definitionsdatei des Zeichens.

 

pdwCharID-

Adresse einer Variablen, die die ID des Zeichens empfängt.

pdwReqID-

Adresse einer Variablen, die die Load Anforderungs-ID empfängt.

Sie können Zeichen aus dem Unterverzeichnis des Microsoft Agent laden, indem Sie einen relativen Pfad angeben (einer, der keinen Doppelpunkt oder führende Schrägstriche enthält). Dadurch wird der Pfad mit dem Zeichenverzeichnis des Agents (im lokalisierten %windows%\msagent-Verzeichnis) vorangestellt. Sie können auch eine relative Adresse verwenden, um Ihr eigenes Verzeichnis im Chars-Verzeichnis des Agents anzugeben.

Sie können dasselbe Zeichen (ein Zeichen mit derselben GUID) nicht mehrmals aus einer einzigen Verbindung laden. Ebenso können Sie das Standardzeichen und andere Zeichen nicht gleichzeitig aus einer einzigen Verbindung laden, da das Standardzeichen mit dem anderen Zeichen identisch sein könnte. Sie können jedoch eine andere Verbindung (mit CoCreateInstance) erstellen und dasselbe Zeichen laden.

Der Datenanbieter des Microsoft-Agents unterstützt das Laden von Zeichendaten, die als einzelne strukturierte Datei gespeichert sind (. ACS) mit Zeichendaten und Animationsdaten zusammen oder als separate Zeichendaten (). ACF) und Animation (. ACA) Dateien. Verwenden Sie im Allgemeinen die einzelne strukturierte Struktur. ACS-Datei zum Laden eines Zeichens, das auf einem lokalen Laufwerk oder Netzwerk gespeichert ist und mit herkömmlichem Dateiprotokoll (z. B. UNC-Pfadnamen) aufgerufen wird. Verwenden Sie die separate . ACF und . ACA-Dateien, wenn Sie die Animationsdateien einzeln von einem Remotestandort laden möchten, auf den sie mithilfe des HTTP-Protokolls zugegriffen werden.

Für. ACS-Dateien mit der Load-Methode bieten Zugriff auf die Animationen eines Zeichens; Nach dem Laden können Sie die Play-Methode verwenden, um das Zeichen zu animieren. Für. ACF-Dateien verwenden Sie auch die Prepare-Methode zum Laden von Animationsdaten. Die Load-Methode unterstützt das Herunterladen nicht. ACS-Dateien von einer HTTP-Website.

Beim Laden eines Zeichens wird das Zeichen nicht automatisch angezeigt. Verwenden Sie zuerst die Show-Methode, um das Zeichen sichtbar zu machen.