Versions Compared

Key

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

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

Синтаксис

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

 

dwRemoteMode комбинация флагов GrdFMR_XXX, задающих режим поиска локальных и/или сетевых ключей

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

dwFlags Зарезервировано. Должно быть NULL.

 

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

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

 
Card
labelC#
Code Block
languagec#
int GRD_API GrdStartupEx(	   DWORD dwRemoteMode,   char    *szNetworkClientIniPath,   void    *pReserved );   

 

 

 

 

Синтаксис

Wiki Markup
{dojo-tabs:theme=tundra|id=1}
{dojo-tab:title=C|selected=true}
*C*
int GRD_API GrdStartupEx(	
  DWORD dwRemoteMode,
  char    *szNetworkClientIniPath,
  void    *pReserved
);	
{dojo-tab}
{dojo-tab:title=C#|selected=true}
C#

{dojo-tab}
{dojo-tab:title=Visual Basic (Declaration)}

{dojo-tab}
{dojo-tab:title=Visual C++}

{dojo-tab}
{dojo-tabs}

...

titleВходные параметры

dwRemoteMode

комбинация флагов GrdFMR_XXX, задающих режим поиска локальных и/или удаленных ключе

rdFMR_Local

Локальный ключ

GrdFMR_Remote

Удаленный ключ

...

szNetworkClientIniPath

...

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

...

pReserved

...

Отсутствует. См. пример для GrdStartup.
Expand
titleВыходные параметры

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

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.

Expand
titleПример