Versions Compared

Old Version 26

changes.mady.by.user Guardant

Saved on

compared with

New Version 27

changes.mady.by.user Guardant

Saved on

Key

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

...

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

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

ЗначениеОписание

GrdFMR_Local

1

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

GrdFMR_Remote

2

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

szNetworkClientIniPath Абсолютный путь, по которому должен располагаться gnclient.ini Путь к файлу gnclient.ini, в зависимости от значения dwFlags. Если параметр равен NULL, то приложение будет искать файл gnclient.ini в директории исполняемого файла, как при использовании GrdStartup.

dwFlags Зарезервировано. Должно быть NULL. Указывает как должен быть интерпретирован путь szNetworkClientIniPath.

GrdRCS_UserDefined

0x00000000

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

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

GrdRCS_ProgramData

0x80000001

Путь задаётся пользователем относительно папки ProgramData.

GrdRCS_EnvVar

0x80000002

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

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

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

 

 

...

Expand
titleОписание

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