Composition Setup

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

Синтаксис

Deck of Cards

id	001

Card

default	true
label	C

Code Block

language	cpp

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

Expand

title	Параметры функции

dwRemoteMode [in]

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

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

szNetworkClientIniPath [in]

Путь к файлу сетевых настроек клиента, в зависимости от значения dwRcsMode.

Info

title

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

	Важно!

Путь (директория) к файлу сетевых настроек может указываться несколькими способами:

Путь заканчивается символом "\" — искать файл в заданной директории. Т.е. строка вида "C:\config\inifile\" означает что защищенное приложение будет искать файл "gnclient.ini" в директории "C:\config\inifile\" .
Путь без символа в конце строки "\" — задает директорию и имя файла сетевых настроек. Т.е. строка вида "C:\config\inifile" означает что защищенное приложение будет искать файл "inifile.ini" в директории "C:\config\" .
Только имя файла — задает имя файла сетевых настроек. Т.е. строка вида "inifile" означает что защищенное приложение будет искать файл "inifile.ini" в той же директории, где находится защищенное приложение.

dwRcsMode [in]

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

GrdRCS_UserDefined

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

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

GrdRCS_ProgramData

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

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

GrdRCS_EnvVar

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

или директории, где будет расположен файл сетевых настроек клиента.

Expand

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

Набор ошибок Guardant API

Expand

title	Описание

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

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

Дополнительно позволяет задать путь к файлу сетевых настроек клиента . Функция GrdStartupEx нужна для работы с сетевыми ключами, когда файл сетевых настроек будет располагаться в директории отличной от расположения исполняемого файла. Параметр szNetworkClientIniPath должен содержать полный путь к файлу или путь к директории заканчивающейся слешем. Во втором случае будет использовано имя файла по умолчанию (gnclient.ini). Если путь задан некорректно или нет прав доступа на запись в указанный файл или директорию, возвращается ошибка GrdE_UnableToCreateIniFile.

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

Card

label	C#

Code Block

language	c#

int GRD_APIpublic static GrdE GrdStartupEx(	   DWORD dwRemoteModeGrdFMR remoteMode, string networkClientIniPath)
public charstatic GrdE   *szNetworkClientIniPathGrdStartupEx(GrdFMR remoteMode, string networkClientIniPath, 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}

Expand

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

dwRemoteMode

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

rdFMR_Local	Локальный ключ
GrdFMR_Remote	Удаленный ключ

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

Expand

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

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

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

GrdRCS rcsMode)

Expand

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

remoteMode [in]

Тип: GrdFMR

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

networkClientIniPath [in]

Путь к файлу сетевых настроек клиента, в зависимости от значения rcsMode. Если параметр rcsMode не указан, необходимо задать полный путь по которому будет расположен данный файл.

rcsMode [in]

Тип: GrdRCS

Позволяет выбрать расположение файла сетевых настроек клиента.

Expand

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

Набор ошибок Guardant API

Expand

title	Описание

Метод GrdStartupEх - первый метод Guardant API, который должен быть вызван из приложения или DLL.

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

Дополнительно метод позволяет задать путь к файлу сетевых настроек клиента. Метод GrdStartupEx нужен для работы с сетевыми ключами, когда файл сетевых настроек будет располагаться в директории отличной от расположения исполняемого файла. Параметр szNetworkClientIniPath должен содержать полный путь к файлу или путь к директории заканчивающейся слешем. Во втором случае будет использовано имя файла по умолчанию (gnclient.ini). Если путь задан некорректно или нет прав доступа на запись в указанный файл или директорию, возвращается ошибка GrdE.UnableToCreateIniFile.

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

Card

label	Java

Code Block

language	java

public static GrdE GrdStartupEx(GrdFMR remoteMode, String networkClientIniPath)
public static GrdE GrdStartupEx(GrdFMR remoteMode, String networkClientIniPath, GrdRCS rcsMode)

Expand

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

remoteMode [in]

Тип: GrdFMR

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

networkClientIniPath [in]

Путь к файлу сетевых настроек клиента, в зависимости от значения rcsMode. Если параметр rcsMode не указан, необходимо задать полный путь по которому будет расположен данный файл.

rcsMode [in]

Тип: GrdRCS

Позволяет выбрать расположение файла сетевых настроек клиента.

Expand

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

Набор ошибок Guardant API

Expand

title	Описание

Метод GrdStartupEх - первый метод Guardant API, который должен быть вызван из приложения или DLL.

В зависимости от параметра remoteMode инициализируются подсистемы API

Expand

title	Описание

Функцию GrdStartupEX необходимо вызвать один раз при старте приложения до вызова каких-либо иных функций Guardant API. В зависимости от параметра dwRemoteMode инициализируются части API

, предназначенные для работы с локальными и/или

с

сетевыми ключами.

Единственным отличием этой функции от "обычной" GrdStartup является возможность задания пути

Дополнительно метод позволяет задать путь к файлу сетевых настроек клиента

gnclient.ini. Поэтому GrdStartupEX нужна при работе

. Метод GrdStartupEx нужен для работы с сетевыми ключами,

особенно в тех случаях, когда невозможно другим способом указать защищенному приложению местоположение gnclient.ini, т. е. при защите dll и Java-приложений.

Если при вызове GrdStartupEx был установлен флаг GrdFMR_Local, то будут найдены только локальные ключи.

Если при вызове GrdStartupEx был установлен флаг GrdFMR_Remote, то будут найдены только сетевые ключи.

Если при вызове GrdStartupEx был установлены оба флага GrdFMR_Local и GrdFMR_Remote, то будут найдены и локальные, и сетевые ключи

когда файл сетевых настроекбудет располагаться в директории отличной от расположения исполняемого файла. Параметр szNetworkClientIniPath должен содержать полный путь к файлу или путь к директории заканчивающейся слешем. Во втором случае будет использовано имя файла по умолчанию (gnclient.ini). Если путь задан некорректно или нет прав доступа на запись в указанный файл или директорию, возвращается ошибка GrdE.UnableToCreateIniFile.

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

_

.AlreadyInitialized .

Expand

title	Пример

Page tree

Versions Compared

Old Version 19

New Version Current

Key

Синтаксис

Синтаксис

Page tree

Page History

Versions Compared

Old Version 19

New Version Current

Key

Синтаксис

Синтаксис