Приложения

Приложение А. Функции, константы и структуры RDS

А.5. Сервисные функции и макросы RDS

А.5.27. Вспомогательный объект для работы с текстом в формате INI-файла

А.5.27.12. Команда RDS_HINI_DELETESECTION – удалить секцию

Команда RDS_HINI_DELETESECTION удаляет из текста секцию с указанным именем.

Вызов команды

  RDSSTR strName= … // Имя секции (UTF8)
  rdsSetObjectStrA(Ini,RDS_HINI_DELETESECTION,0,strName);

или

  RDSWSTR strName= … // Имя секции (UTF16)
  rdsSetObjectStrW(Ini,RDS_HINI_DELETESECTION,0,strName);

или (через функцию-псевдоним)

  RDSXSTR strName= … // Имя секции (кодировка по умолчанию)
  rdsSetObjectStr(Ini,RDS_HINI_DELETESECTION,0,strName);

Параметры и результат

Ini (RDS_HOBJECT): Идентификатор вспомогательного объекта для работы с текстом, ранее созданного функцией rdsINICreateTextHolder.
strName (RDSSTR, RDSWSTR, RDSXSTR): Указатель на строку, в которой записано имя удаляемой секции.

Примечания

Эта команда удаляет из текста, хранящегося в объекте Ini, секцию с именем strName вместе со всеми находящимися в ней параметрами. Если эта секция была текущей, после ее удаления объект не будет иметь текущей секции и все вызовы чтения и записи параметров будут игнорироваться.

См. также

rdsINICreateTextHolder, rdsSetObjectStr, rdsINIOpenSection, RDS_HINI_CREATESECTION.