Функция GrdStartupEх инициализирует данную копию Guardant API и позволяет задать путь к файлу сетевых настроек клиента gnсlient.ini.
Синтаксис
C
int GRD_API GrdStartupEx(
DWORD dwRemoteMode,
char *szNetworkClientIniPath,
void *pReserved
);
C#
Входные параметры
dwRemoteMode | комбинация флагов GrdFMR_XXX, задающих режим поиска локальных и/или удаленных ключей |
rdFMR_Local | Локальный ключ |
GrdFMR_Remote | Удаленный ключ |
szNetworkClientIniPath | Абсолютный путь, по которому должен располагаться gnclient.ini. Если параметр равен NULL, то приложение будет искать файл gnclient.ini в директории исполняемого файла, как при использовании GrdStartup. |
pReserved | Зарезервировано. Должно быть NULL. |
Выходные параметры
Описание
Функцию GrdStartupEX необходимо вызвать один раз при старте приложения до вызова каких-либо иных функций Guardant API. В зависимости от параметра dwRemoteMode инициализируются части API, предназначенные для работы с локальными и/или с сетевыми ключами.
Единственным отличием этой функции от "обычной" GrdStartup является возможность задания пути к файлу сетевых настроек клиента gnclient.ini. Поэтому GrdStartupEX нужна при работе с сетевыми ключами, особенно в тех случаях, когда невозможно другим способом указать защищенному приложению местоположение gnclient.ini, т. е. при защите dll и Java-приложений.
Если при вызове GrdStartupEx был установлен флаг GrdFMR_Local, то будут найдены только локальные ключи.
Если при вызове GrdStartupEx был установлен флаг GrdFMR_Remote, то будут найдены только сетевые ключи.
Если при вызове GrdStartupEx был установлены оба флага GrdFMR_Local и GrdFMR_Remote, то будут найдены и локальные, и сетевые ключи.
Если данная копия Guardant API уже была инициализирована, возвращается ошибка GrdE_AlreadyInitialized.
Пример
Отсутствует. См. пример для GrdStartup.