Методы



Connect(AAddressAndPort, AUserName, APassword)

Подключает клиента к RPC-серверу.

AAddressAndPort - адрес и порт сервера. По умолчанию сервер принимает подключения на "0.0.0.0:40404".

AUserName и APassword - данные аутентификации клиента.

При неудачном подключении будет возбуждено исключение.

Disconnect

Отключает клиента от сервера. После вызова данного метода все ссылки на удаленные объекты становятся некорректными. По этой причине перед вызовом данного метода необходимо сначала уничтожить все удаленные объекты.

Например в VBScript:

Set MyRemoteObject = Nothing

RequestObject(AObjectIDString as String) as Variant;

Запрашивает удаленный объект у сервера.

AObjectIDString может быть AppID любого системного объекта, например "Shell.Application".

Если AObjectIDString является пользовательской строкой - RPC-сервер должен проанализировать эту строку в событии OnRequestObject и вернуть клиенту необходимый системный или внутренний объект сервера.

Заметьте: в демонстрационной версии пользовательские имена объектов нельзя использовать.

 

Пример для VBScript:

 

 

 

'Создаем объект RPC-клиента

Set RPCClient = WScript.CreateObject("RoutixRPCCOM.Client")

 

'Подключаемся к серверу

RPCClient.Connect "127.0.0.1:40404", "RoutixUser", "Secret"

 

 

'Запрашиваем нужный объект с сервера

Set fso = RPCClient.RequestObject("Scripting.FileSystemObject")

 

 

Const WindowsFolder   = 0

Const SystemFolder    = 1

Const TemporaryFolder = 2

 

'Вызываем методы удаленного объекта

WScript.Echo fso.GetSpecialFolder(WindowsFolder)

WScript.Echo fso.GetSpecialFolder(SystemFolder)

WScript.Echo fso.GetSpecialFolder(TemporaryFolder)

 

'Все полученные от сервера объекты должны быть

'уничтожены до того, как будет уничтожен сам объект RPC-клиента!

Set fso = Nothing

 

'Уничтожаем сам RPC-клиент

Set RPCClient = Nothing

 

 

WScript.Echo vbCRLF & "Нажмите клавишу "ANYKEY"..."

WScript.StdIn.Read(1)