Справочник по технологии COM
Страница 14. SysAllocStringLen


 

SysAllocStringLen

Выделяет новую строку, копирует в нее cch символов из заданной строки, после чего добавляет нулевой символ.

BSTR SysAllocStringLen( 
OLECHAR FAR* pch,
unsigned int cch
);

Параметры:

  • pch - Указатель на cch символов, которые следует скопировать, или NULL, чтобы оставить новую строку неинициализированной.
  • cch - Число символов, которые нужно скопировать из pch. После этих символов добавляется нулевой символ, т. е. всего выделяется память для cch+1 символов.

Возвращаемое значение:
Указатель на копию строки или NULL, если не хватает памяти.

Комментарии:
Если pch равен NULL, то строка запрошенной длины выделяется, но не инициализируется. Строка pch может содержать внутри нулевые символы и не обязана заканчиваться таким символом. Для освобождения полученной строки используйте SysFreeString.

 
Следующая статья »