Метод GrdFind осуществляет поиск локального или удаленного ключа, удовлетворяющего критериям поиска, установленным при последнем вызове GrdSetFindMode и возвращает ошибку GrdE.OK, а также ID этого ключа, в том случае, если такой ключ найден, а также класс GrdFindInfo, содержащий данные о найденном ключе. Если производится поиск сетевого ключа, метод GrdFind опрашивает все сервера Guardant Net, доступные для данной копии приложения в соответствии с параметрами установленными в конфигурационном файле сетевых настроек клиента. Если производится поиск локальных ключей, то метод обнаруживает только те ключи, которые подключены непосредственно к данной рабочей станции. При помощи метода GrdFind можно построить список ключей, удовлетворяющим критериям поиска, выполняя поиск последовательно и записывая данные о ключах в массив, до тех пор пока метод не вернет ошибки GrdE.DongleNotFound или GrdE.AllDonglesFound. Если не будет найдено ни одного ключа, удовлетворяющего критериям поиска, метод вернет ошибку GrdE.DongleNotFound. После того, как список ключей построен, можно выбрать из них нужный и при дальнейшей работе использовать его, установив критерием поиска ID нужного ключа. При первом вызове GrdFind для вновь установленных методом GrdSetFindMode критериях поиска в параметре mode следует установить значение First, при всех последующих вызовах до изменения критериев поиска нужно устанавливать значение Next. GrdFind необходимо вызывать в рамках блока инициализации, до вызова GrdLogin. При попытке вызова GrdFind на залогиненном хэндле будет возвращена ошибка GrdE.NeedLogout. Если GrdFind вызвать до установки Общего кода (Public Code), см. GrdSetAccessCodes, то будут найдены все доступные ключи Guardant с любыми кодами. После вызова GrdSetAccessCodes метод GrdFind будет искать только ключи с заданным Общим кодом. |