Page tree
Skip to end of metadata
Go to start of metadata

Функция(метод)  GrdStartup вызывается первой(ым) из приложения или DLL. Дополнительно позволяет задать путь к файлу сетевых настроек клиента.  

Синтаксис

    int GRD_API GrdStartupEx(
      DWORD dwRemoteMode,
      const char* szNetworkClientIniPath,
      DWORD dwRcsMode
    );
    
     Параметры функции

    dwRemoteMode [in] 

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

    GrdFMR_Local

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

    GrdFMR_Remote

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

    szNetworkClientIniPath [in] 

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

     

    Важно!

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

    • Путь заканчивается символом "\" — искать файл в заданной директории. Т.е. строка вида "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  должен содержать имя переменной окружения, которая содержит полный путь к файлу

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

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

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

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

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

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

    public static GrdE GrdStartupEx(GrdFMR remoteMode, string networkClientIniPath)
    public static GrdE GrdStartupEx(GrdFMR remoteMode, string networkClientIniPath, GrdRCS rcsMode)
    
    
     Параметры метода

    remoteMode [in] 

    Тип: GrdFMR

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

    networkClientIniPath [in]

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

    rcsMode [in]

    Тип: GrdRCS

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

     Возвращаемое значение метода
     Описание

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

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

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

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

    public static GrdE GrdStartupEx(GrdFMR remoteMode, String networkClientIniPath)
    public static GrdE GrdStartupEx(GrdFMR remoteMode, String networkClientIniPath, GrdRCS rcsMode)
     Параметры метода

    remoteMode [in] 

    Тип: GrdFMR

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

    networkClientIniPath [in]

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

    rcsMode [in]

    Тип: GrdRCS

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

     Возвращаемое значение метода
     Описание

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

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

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

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

     

     

     

     

     

     

     

     

     

     

     

     

    • No labels