Приложения

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

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

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

А.5.27.22. Макрос rdsINIDeleteValue – удалить параметр из текущей секции

Макрос rdsINIDeleteValue удаляет из текущей секции текста параметр с указанным именем.

  rdsINIDeleteValueA(
    ini,     // Вспомогательный объект
    key      // Имя параметра (UTF8)
  )
  rdsINIDeleteValueW(
    ini,     // Вспомогательный объект
    key      // Имя параметра (UTF16)
  )
  // Через функцию-псевдоним
  rdsINIDeleteValue(
    ini,     // Вспомогательный объект
    key      // Имя параметра (кодировка по умолчанию)
  )

Определение

  #define rdsINIDeleteValueA(ini,key) \
    rdsSetObjectStrA((ini),RDS_HINI_DELETEKEYLAST,0,(key))
  #define rdsINIDeleteValueW(ini,key) \
    rdsSetObjectStrW((ini),RDS_HINI_DELETEKEYLAST,0,(key))
  // Через функцию-псевдоним
  #define rdsINIDeleteValue(ini,key) \
    rdsSetObjectStr((ini),RDS_HINI_DELETEKEYLAST,0,(key))

Параметры

ini (RDS_HOBJECT)

Идентификатор вспомогательного объекта для работы с текстом, ранее созданного функцией rdsINICreateTextHolder.

key (RDSCSTR, RDSWCSTR, RDSXCSTR)

Указатель на строку с именем удаляемого параметра.

Примечания

Макрос rdsINIDeleteValue заключает в себя вызов команды RDS_HINI_DELETEKEYLAST.