Versions Compared

Key

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

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

 

Expand
titleСинтаксис

Синтаксис

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}
Expand
titleВходные параметры

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

dwRemoteMode

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

rdFMR_Local

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

GrdFMR_Remote

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

szNetworkClientIniPath

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

pReserved

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

 
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Пример

Пример

Отсутствует. См. пример для GrdStartup.