Приложения

Приложение А. Функции, константы и структуры 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.