IAgent::Load

[Der Microsoft-Agent ist ab Windows 7 veraltet und in nachfolgenden Versionen von Windows möglicherweise nicht mehr 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 variant-Datentyp, der einen der folgenden Sein muss:

Wert BESCHREIBUNG
Dateinamen 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 (einen Pfad, 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 Chars-Verzeichnis des Agents anzugeben.

Sie können das gleiche 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 weitere Verbindung (mit CoCreateInstance) erstellen und das gleiche 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 . ACS-Datei zum Laden eines Zeichens, das auf einem lokalen Laufwerk oder Netzwerk gespeichert ist und auf das mithilfe eines herkömmlichen Dateiprotokolls (z. B. UNC-Pfadnamen) zugegriffen wird. Verwenden Sie die separate . ACF und . ACA-Dateien, wenn Sie die Animationsdateien einzeln von einem Remotestandort laden möchten, an dem über das HTTP-Protokoll auf sie zugegriffen wird.

Für. ACS-Dateien, die die Load-Methode verwenden, bieten Zugriff auf die Animationen eines Zeichens. Nach dem Laden können Sie das Zeichen mithilfe der Play-Methode 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.