Функция GrdStartupEх инициализирует данную копию Guardant API и позволяет задать путь к файлу сетевых настроек клиента gnсlient.ini.

Синтаксис

int GRD_API GrdStartupEx(
	DWORD dwRemoteMode,
	const char* szNetworkClientIniPath,
	DWORD dwFlags
);

dwRemoteMode [in]

Комбинация флагов, задающих режим поиска ключей.

Значение

Описание

GrdFMR_Local

1

Поиск локальных ключей.

GrdFMR_Remote

2

Поиск сетевых ключей.

szNetworkClientIniPath [in]

Путь к файлу gnclient.ini, в зависимости от значения dwFlags.

dwFlags [in]

Указывает как должен быть интерпретирован параметр szNetworkClientIniPath.

GrdRCS_UserDefined

0x00000000

Путь задаётся пользователем. Параметр szNetworkClientIniPath должен содержать полный путь к файлу или директории, где расположен файл gnclient.ini.

Если параметр szNetworkClientIniPath равен NULL, то приложение будет искать файл gnclient.ini в директории исполняемого файла.

GrdRCS_ProgramData

0x80000001

Путь задаётся пользователем относительно общей папки ProgramData (для Windows) или переменной окружения HOME (для Linux). Параметр szNetworkClientIniPath должен

содержать относительный путь к файлу или директории, где расположен файл gnclient.ini.

GrdRCS_EnvVar

0x80000002

Путь определяется через переменную окружения. Параметр szNetworkClientIniPath должен содержать имя переменной окружения, которая содержит полный путь к файлу

или директории, где расположен файл gnclient.ini.

Cтандартный набор ошибок

public static GrdE GrdStartupEx(
	GrdFMR remoteMode,
	string networkClientIniPath
)

Функцию 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.