---
title: "ksGetSystemProfileString - Получить строку из INI-файла системы или из Registry"
type: guide
api: [api7]
tags: [guide, api7, ksgetsystemprofilestring]
sources:
  - ksgetsystemprofilestring.html
---

*API экспортных функций > Функции работы с документами  > Сервисные функции *


## ksGetSystemProfileString - Получить строку из INI-файла системы или из Registry

Пример...
Аналог данной функции при использовании Automation - метод KompasObject::ksGetSystemProfileString.
Синтаксис:
```
int ksGetSystemProfileString (char *lpSection,
char *lpKey,
char *lpReturnedString,
int bufLen);
Выходные параметры:
lpSection    - имя секции,
lpKey    - имя ключа,
lpReturnedString    - буфер для выходной строки,
bufLen    - длина отведенного буфера в символах.
Возвращаемое значение:
1    - в случае удачного завершения,
0    - в случае неудачи.
```
Пример:
```vb
lpSection = "Directories"
lpKey = "Sys"
Результат:
lpReturnedString = "c:\Program Files\Kompas54\Sys"
iSize = 29
```
Примечание:
1. Если lpReturnedString = 0 или bufLen = 0, то возвращается необходимая длина буфера в символах, иначе - возвращается количество переписанных байт (с учетом завершающего 0).
2. Если возвращаемое значение = 0, значит секция или ключ не были найдены ни в INI-файле, ни в реестре.


## ksGetSystemProfileString - пример использования

char buf[255];
if (ksGetSystemProfileString("Directories", "SYS", buf, 255))
Message(buf);
else
Error("Ключ не найден");
