Функция AllocCountedString
Примечание
Платформа защиты доступа к сети недоступна, начиная с Windows 10
Функция AllocCountedString выделяет память для строки, завершаемой значением NULL, и возвращает ее в структуре CountedString .
Синтаксис
NAPAPI HRESULT WINAPI AllocCountedString(
_Inout_ CountedString **countedString,
_In_ const WCHAR *string
);
Параметры
-
countedString [in, out]
-
Указатель на адрес только что выделенной структуры CountedString .
-
string [in]
-
Указатель на строку, завершающуюся значением NULL, которая должна быть возвращена в countedString.
Возвращаемое значение
| Код возврата | Описание |
|---|---|
|
Операция успешно завершена. |
|
Передан недопустимый аргумент. |
|
В системе отсутствует виртуальная память. Эта операция завершилась сбоем. |
Комментарии
Все COM-интерфейсы, поддерживаемые системой NAP, используют стандартные правила управления памятью COM и распределители памяти COM (CoTaskMemAlloc и CoTaskMemFree):
- В параметры выделяются и освобождаются вызывающим объектом.
- Параметры out выделяются вызываемым объектом и освобождаются вызывающим объектом с помощью CoTaskMem.
- Параметры входа и выхода выделяются вызывающим объектом, освобождаются и перераспределяются вызываемым объектом и в конечном итоге освобождаются вызывающим объектом с помощью CoTaskMem.
Все функции NAP для освобождения памяти также освобождают все внедренные указатели.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента |
Windows Vista [только классические приложения] |
| Минимальная версия сервера |
Windows Server 2008 [только классические приложения] |
| Заголовок |
|
| DLL |
|