Метод ITSRemoteProgram::ServerStartProgram

  • Статья

Указывает программу RemoteApp, запускаемую в удаленном сеансе. Эта функция должна вызываться в подключенном сеансе (после получения уведомления о подключении сеанса на клиенте). В сеансе можно запустить любое количество программ RemoteApp. Сеанс RemoteApp будет истекать, если в сеансе не запущена программа RemoteApp в течение предельного времени ожидания, которое составляет две минуты для Windows Server 2008.

Синтаксис

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 и наоборот. Следует указать только один из параметров.

bstrWorkingDirectory [in]

Рабочий каталог на сервере для программы RemoteApp.

vbExpandEnvVarInWorkingDirectoryOnServer [in]

Указывает, должен ли сервер развертывать переменные среды в пути к рабочему каталогу. Задайте для этого параметра значение VARIANT_TRUE , если путь к рабочему каталогу содержит переменные среды, или VARIANT_FALSE , если путь к рабочему каталогу не содержит переменных среды.

bstrArguments [in]

Аргументы командной строки для программы RemoteApp, указанные в bstrExecutablePath. Установите значение NULL , если bstrExecutablePath не указан.

vbExpandEnvVarInArgumentsOnServer [in]

Указывает, должен ли сервер расширять переменные среды в аргументах командной строки. Задайте для этого параметра значение VARIANT_TRUE , содержат ли аргументы переменные среды, или VARIANT_FALSE , если аргументы не содержат переменные среды.

Возвращаемое значение

В случае успешного выполнения возвращает S_OK .

Требования

Требование Значение
Минимальная версия клиента
 Windows Vista
Минимальная версия сервера
 Windows Server 2008
Библиотека типов
MsTscAx.dll
DLL
MsTscAx.dll
IID
 IID_ITSRemoteProgram определяется как FDD029F9-467A-4c49-8529-64B521DBD1B4

См. также раздел

ITSRemoteProgram2

ITSRemoteProgram3

ITSRemoteProgram