Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Deck of Cards
id001
Card
defaulttrue
labelC
Code Block
languagecpp
int GRD_API GrdStartupEx(
	DWORD dwRemoteMode,
	const char* szNetworkClientIniPath,
	DWORD dwFlags
);
Expand
titleПараметры функции

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.

Expand
titleВозвращаемое значение функции

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

 
Card
labelC#
Code Block
languagec#
public static GrdE GrdStartupEx(GrdFMR remoteMode, string networkClientIniPath)
public static GrdE GrdStartupEx(GrdFMR remoteMode, string networkClientIniPath, GrdRCS rcsMode)

Expand
titleПараметры метода

remoteMode [in] 

Тип: GrdFMR

Позволяет задать режим поиска ключей. 

Expand
titleВозвращаемое значение метода

 

Card
labelJava
Code Block
languagejava
 public static GrdE GrdStartupEx(GrdFMR remoteMode, String networkClientIniPath, GrdRCS rcsMode)
Expand
titleПараметры метода

remoteMode [in] 

Тип: GrdFMR

Позволяет задать режим поиска ключей. 

Expand
titleВозвращаемое значение метода

 

Expand
titleОписание

Функция GrdStartupEх должна быть первой функцией Guardant API вызванной из приложения или DLL.

В зависимости от параметра dwRemoteMode инициализируются подсистемы API, предназначенные для работы с локальными и/или сетевыми ключами.

Дополнительно позволяет задать путь к файлу сетевых настроек клиента gnclient.ini. Функция GrdStartupEx нужна для работы с сетевыми ключами,  когда файл настроек gnclient.ini должен располагаться в директории отличной от расположения исполняемого файла.

Если данная копия Guardant API уже была инициализирована, возвращается ошибка GrdE_AlreadyInitialized.