ITSRemoteProgram::ServerStartProgram メソッド

リモート セッションで開始する RemoteApp プログラムを指定します。 この関数は、接続されたセッションで呼び出す必要があります (セッション接続済み通知がクライアントで受信された後)。 セッションでは、任意の数の RemoteApp プログラムを開始できます。 タイムアウト制限 (Windows Server 2008 の場合は 2 分) 内に RemoteApp プログラムがセッションで開始されていない場合、RemoteApp セッションはタイムアウトします。

構文

HRESULT ServerStartProgram(
  [in] BSTR         bstrExecutablePath,
  [in] BSTR         bstrFilePath,
  [in] BSTR         bstrWorkingDirectory,
  [in] VARIANT_BOOL vbExpandEnvVarInWorkingDirectoryOnServer,
  [in] BSTR         bstrArguments,
  [in] VARIANT_BOOL vbExpandEnvVarInArgumentsOnServer
);

パラメーター

bstrExecutablePath [in]

サーバー上の RemoteApp プログラム実行可能ファイルのパス。

bstrFilePath [in]

ファイルの関連付けを介してサーバー上で開くファイルのパス (例: "C:\\Documents\\MyReport.docx")。 bstrFilePath を指定する場合は、bstrExecutablePath パラメーターを指定しないでください。その逆も同様です。 パラメーターの 1 つだけを指定する必要があります。

bstrWorkingDirectory [in]

RemoteApp プログラムのサーバー上の作業ディレクトリ。

vbExpandEnvVarInWorkingDirectoryOnServer [in]

サーバーが作業ディレクトリ パス内の環境変数を展開する必要があるかどうかを示します。 作業ディレクトリ パスに環境変数が含まれている場合は、このパラメーターを VARIANT_TRUE に設定するか、作業ディレクトリ パスに環境変数が含まれていない場合は VARIANT_FALSE します。

bstrArguments [in]

bstrExecutablePath で指定された RemoteApp プログラムのコマンド ライン引数。 bstrExecutablePath が指定されていない場合は、これを NULL に設定します。

vbExpandEnvVarInArgumentsOnServer [in]

コマンド ライン引数でサーバーが環境変数を展開する必要があるかどうかを示します。 引数に環境変数が含まれている場合は、このパラメーターを VARIANT_TRUE に設定し、引数に環境変数が含まれていない場合は VARIANT_FALSE します。

戻り値

成功した場合 はS_OK を返します。

必要条件

関連項目

ITSRemoteProgram2

ITSRemoteProgram3

ITSRemoteProgram