IAgent::Load

[Microsoft エージェントは Windows 7 の時点で非推奨となり、以降のバージョンの 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
);

Characters コレクションに文字を読み込みます。

• 操作が成功したことを示すS_OKを返します。

vLoadKey

次のいずれかである必要があるバリアント 型のデータ型。

値	説明
filespec	指定した文字の定義ファイルのローカル ファイルの場所。
URL	文字の定義ファイルの HTTP アドレス。

 

pdwCharID

文字の ID を受け取る変数のアドレス。

pdwReqID

Load 要求 ID を受け取る変数のアドレス。

Microsoft Agent サブディレクトリから文字を読み込むには、相対パス (コロンまたは先頭のスラッシュ文字を含まないパス) を指定します。 これにより、パスの前にエージェントの characters ディレクトリが付きます (ローカライズされた %windows%\msagent ディレクトリにあります)。 また、相対アドレスを使用して、エージェントの Chars ディレクトリに独自のディレクトリを指定することもできます。

同じ文字 (同じ GUID を持つ文字) を 1 つの接続から複数回読み込むことはできません。 同様に、1 つの接続から既定の文字とその他の文字を同時に読み込むことはできません。既定の文字は他の文字と同じになる可能性があるためです。 ただし、(CoCreateInstance を使用して) 別の接続を作成し、同じ文字を読み込むことができます。

Microsoft エージェントのデータ プロバイダーは、1 つの構造化ファイルとして格納された文字データの読み込みをサポートしています (。ACS) と文字データとアニメーション データを一緒に使用するか、個別の文字データ (。ACF) とアニメーション (.ACA) ファイル。 一般に、単一の構造化 を使用します。ローカル ディスク ドライブまたはネットワークに格納され、従来のファイル プロトコル (UNC パス名など) を使用してアクセスされる文字を読み込む ACS ファイル。 別の を使用します。ACF および 。アニメーション ファイルを HTTP プロトコルを使用してアクセスされるリモート サイトから個別に読み込む場合は、ACA ファイル。

の場合。 LOAD メソッドを使用して ACS ファイルを使用すると、キャラクタのアニメーションにアクセスできます。読み込まれたら、 Play メソッドを使用してキャラクターをアニメーション化できます。 の場合。ACF ファイルでは、 Prepare メソッドを使用してアニメーション データを読み込むこともできます。 Load メソッドでは、 のダウンロードはサポートされていません。HTTP サイトからの ACS ファイル。

文字を読み込むと、文字は自動的に表示されません。 最初に Show メソッドを使用して、文字を表示します。