Метод ITSRemoteProgram::ServerStartProgram

Статья
06/13/2023

Указывает программу 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

Поделиться через