Microsoft DirectX 8.0 (C++)

IDirectMusicScript8::SetVariableVariant

スクリプト内で宣言された変数にバリアント値を設定する。

HRESULT SetVariableVariant(
  WCHAR *pwszVariableName,
  VARIANT varValue, 
  BOOL fSetRef,
  DMUS_SCRIPT_ERRORINFO *pErrInfo
);

パラメータ

pwszVariableName
スクリプトの変数名。
varValue
変数に割り当てる値。
fSetRef
変数が参照により設定される場合は TRUE、値により設定される場合は FALSE。参照によって設定できるのはオブジェクトだけである。このフラグには、DirectMusic オブジェクトに対しては常に TRUE を指定し、その他の変数に対しては FALSE を指定する。
pErrInfo
エラーが発生した場合に、情報を受け取る DMUS_SCRIPT_ERRORINFO 構造体のアドレス。エラー情報が必要でない場合は、このメンバに NULL を設定する。

戻り値

成功した場合は、次のいずれかのコードを返す。

S_OK 値が設定された。
S_FALSE スクリプトに変数が存在しない。
DMUS_S_GARBAGE_COLLECTED ガベージ コレクション」を参照すること。

失敗した場合は、次のいずれかの値を返す。

DMUS_E_NOT_INIT
DMUS_E_SCRIPT_CONTENT_READONLY
DMUS_E_SCRIPT_NOT_A_REFERENCE
DMUS_E_SCRIPT_UNSUPPORTED_VARTYPE
DMUS_E_SCRIPT_VALUE_NOT_SUPPORTED
DMUS_E_SCRIPT_VARIABLE_NOT_FOUND
E_POINTER

動作環境

  ヘッダー : dmusici.h で宣言。

参照

IDirectMusicScript8::GetVariableObject