---
title: "ksGetSpcSectionName - Получить название раздела спецификации, которому принадлежит указанный объект спецификации"
type: guide
api: [api7]
tags: [guide, api7, ksgetspcsectionname]
sources:
  - ksgetspcsectionname.html
---

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


## ksGetSpcSectionName - Получить название раздела спецификации, которому принадлежит указанный объект спецификации

Пример...
Аналог данной функции при использовании Automation - метод ksSpecification::ksGetSpcSectionName.
Синтаксис:
```
int ksGetSpcSectionName (reference spcObj, char* name, int size);
Входной параметр:
spcObj    - указатель на объект спецификации.
Выходные параметры:
name    - буфер для имени раздела,
size    - размер буфера.
Возвращаемое значение:
1    - в случае удачного завершения,
0    - в случае неудачи.
Примечание.
При использовании Unicode следует использовать функцию ksGetSpcSectionNameW.
```


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

// создадим итератор по вспомогательным объектам спецификации в текущем документе
reference iter = ::CreateSpcIterator (0, 0, 1/*вспомогательные объекты спецификации*/);
if (iter) {
// встаем на первый объект спецификации
reference spcObj = ::MoveIterator (iter, 'F');
// проверяем, что объект действительно существует
if (spcObj && ::ExistObj (spcObj)) {
do {
char spcSectionName[128]; // имя раздела спецификации
// запрашиваем имя раздела
if (::ksGetSpcSectionName (spcObj, spcSectionName, sizeof (spcSectionName)))
::Message (spcSectionName);
// встаем на следующий объект спецификации
spcObj = ::MoveIterator (iter, 'N');
} while (spcObj && ::ExistObj (spcObj));
}
::DeleteIterator(iter); // удаляем итератор
}