Текущий раздел:

Описания RDS

Приложения

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

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

А.5.6. Операции с блоками и связями

А.5.6.7. rdsCreateFullBlockNameString – полное имя блока

# Приложения

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

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

#### А.5.6. Операции с блоками и связями

##### А.5.6.7. rdsCreateFullBlockNameString – полное имя блока

Функция rdsCreateFullBlockNameString формирует в памяти динамическую строку с полным именем блока, идентификатор которого передан в ее параметрах.

      RDSSTR RDSCALL rdsCreateFullBlockNameStringA( // UTF8
        RDS_BHANDLE Block, // Идентификатор блока
        int *pLength       // Возвращаемая длина строки
      );
      RDSWSTR RDSCALL rdsCreateFullBlockNameStringW( // UTF16
        RDS_BHANDLE Block, // Идентификатор блока
        int *pLength       // Возвращаемая длина строки
      );
      // Функция-псевдоним
      RDSXSTR RDSCALL rdsCreateFullBlockNameString( // Кодировка по умолчанию
        RDS_BHANDLE Block, // Идентификатор блока
        int *pLength       // Возвращаемая длина строки
      );

Тип указателя на эту функцию

RDS_SBhpI (для UTF8) или RDS_WsBhpI (для UTF16)

Параметры

Block(RDS_BHANDLE)
  Идентификатор блока, полное имя которого должна вернуть функция.
pLength(int*)
  Указатель на целую переменную, в которую функция должна записать длину получившейся строки. Если вызывающей программе не нужна длина строки, в этом параметре можно передать NULL.

Возвращаемое значение

Указатель на созданную в динамической памяти строку, в которой сформировано полное имя блока. Полное имя начинается с двоеточия, за которым следует последовательное перечисление через двоеточие всех имен подсистем на пути от корневой подсистемы до этого блока, завершающееся именем самого блока (например, «:Sys1:Sys100:Block1»). В случае ошибки возвращается NULL.

Примечания

Динамическая строка, созданная функцией rdsCreateFullBlockNameString, должна быть обязательно освобождена функцией rdsFree.

См. также

rdsFree, rdsBlockByFullName.