Функция(метод) GrdStartupEх вызывается первой(ым) из приложения или DLL. Дополнительно позволяет Функция GrdStartupEх инициализирует данную копию Guardant API и позволяет задать путь к файлу сетевых настроек клиента gnсlient.ini.
Синтаксис
Deck of Cards |
---|
|
Card |
---|
| Code Block |
---|
theme | Eclipse |
---|
language | cpp |
---|
title | GrdStarupEx |
---|
| intint GRD_API GrdStartupEx(
DWORD dwRemoteMode,
const char * *szNetworkClientIniPath,
void *pReserved DWORD dwRcsMode
);
|
Expand |
---|
| dwRemoteMode [in] Комбинация флагов, задающих режим поиска ключей. GrdFMR_Local | Поиск локальных ключей. | GrdFMR_Remote | Поиск сетевых ключей. |
szNetworkClientIniPath [in] Путь к файлу сетевых настроек клиента, в зависимости от значения dwRcsMode. Info |
---|
| Путь (директория) к файлу сетевых настроек может указываться несколькими способами: - Путь заканчивается символом "\" — искать файл в заданной директории. Т.е. строка вида "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 |
---|
| Функция GrdStartupEх должна быть первой функцией Guardant API вызванной из приложения или DLL. В зависимости от параметра dwRemoteMode инициализируются подсистемы API, предназначенные для работы с локальными и/или сетевыми ключами. Дополнительно позволяет задать путь к файлу сетевых настроек клиента . Функция GrdStartupEx нужна для работы с сетевыми ключами, когда файл сетевых настроек будет располагаться в директории отличной от расположения исполняемого файла. Параметр szNetworkClientIniPath должен содержать полный путь к файлу или путь к директории заканчивающейся слешем. Во втором случае будет использовано имя файла по умолчанию (gnclient.ini). Если путь задан некорректно или нет прав доступа на запись в указанный файл или директорию, возвращается ошибка GrdE_UnableToCreateIniFile. Если данная копия Guardant API уже была инициализирована, возвращается ошибка GrdE_AlreadyInitialized. |
|
Card |
---|
| Code Block |
---|
language | c# |
---|
title | GrdStartup |
---|
| 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 |
---|
|
dwRemoteMode | комбинация флагов GrdFMR_XXX, задающих режим поиска локальных и/или удаленных ключе |
rdFMR_Local | Локальный ключ | GrdFMR_Remote | Удаленный ключ |
szNetworkClientIniPath | Абсолютный путь, по которому должен располагаться gnclient.ini. Если параметр равен NULL, то приложение будет искать файл gnclient.ini в директории исполняемого файла, как при использовании GrdStartup. | pReserved | Зарезервировано. Должно быть NULL. |
|
Expand |
---|
| Метод GrdStartupEх - первый метод Guardant API, который должен быть вызван из приложения или DLL. В зависимости от параметра remoteMode инициализируются подсистемы API, предназначенные для работы с локальными и/или сетевыми ключами. Дополнительно метод позволяет задать путь к файлу сетевых настроек клиента. Метод GrdStartupEx нужен для работы с сетевыми ключами, когда файл сетевых настроек будет располагаться в директории отличной от расположения исполняемого файла. Параметр szNetworkClientIniPath должен содержать полный путь к файлу или путь к директории заканчивающейся слешем. Во втором случае будет использовано имя файла по умолчанию (gnclient.ini). Если путь задан некорректно или нет прав доступа на запись в указанный файл или директорию, возвращается ошибка GrdE.UnableToCreateIniFile. Если данная копия Guardant API уже была инициализирована, возвращается ошибка GrdE.AlreadyInitialized . |
|
Card |
---|
| Code Block |
---|
| public static GrdE GrdStartupEx(GrdFMR remoteMode, String networkClientIniPath)
public static GrdE GrdStartupEx(GrdFMR remoteMode, String networkClientIniPath, GrdRCS rcsMode) |
Expand |
---|
| Метод GrdStartupEх - первый метод Guardant API, который должен быть вызван из приложения или DLL. В зависимости от параметра remoteMode инициализируются подсистемы API |
|
|
Expand |
---|
|
Функцию 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 |
| _ |
Expand |
---|
|
Отсутствует. См. пример для GrdStartup. |