IAgent::Load

[Microsoft Agent ist ab Windows 7 veraltet und in nachfolgenden Versionen von Windows möglicherweise nicht verfügbar.]

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 Variantendatentyp, der einer 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 Microsoft Agent-Unterverzeichnis laden, indem Sie einen relativen Pfad angeben (der keinen Doppelpunkt oder führenden Schrägstrich enthält). Dadurch wird dem Pfad das Zeichenverzeichnis des Agents vorangestellt (im lokalisierten Verzeichnis %windows%\msagent). Sie können auch eine relative Adresse verwenden, um Ihr eigenes Verzeichnis im Verzeichnis Chars des Agents anzugeben.

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

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

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 den Charakter zu animieren. Für. ACF-Dateien verwenden Sie auch die Prepare-Methode , um Animationsdaten zu laden. Das Herunterladen von wird von der Load-Methode nicht unterstützt. 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.