Функция AllocADsStr (adshlp.h)
Функция AllocADsStr выделяет память для указанной строки и копирует ее.
Синтаксис
LPWSTR AllocADsStr(
[in] LPCWSTR pStr
);
Параметры
[in] pStr
Тип: LPWSTR
Указатель на строку Юникода, завершаемую null, которая требуется скопировать.
Возвращаемое значение
Тип: LPWSTR
При успешном выполнении функция возвращает указатель, отличный от NULL , на выделенную память. Строка в pStr копируется в этот буфер и завершается значением NULL. Вызывающий объект должен освободить эту память, если она больше не требуется, передав возвращенный указатель в FreeADsStr.
В случае успеха возвращает значение NULL . Вызовите ADsGetLastError , чтобы получить расширенное состояние ошибки. Дополнительные сведения о значениях кодов ошибок см. в разделе Коды ошибок ADSI.
Комментарии
Дополнительные сведения и пример кода, демонстрирующий использование функции AllocADsStr , см. в разделе ReallocADsStr.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows Vista |
| Минимальная версия сервера | Windows Server 2008 |
| Целевая платформа | Windows |
| Header | adshlp.h |
| Библиотека | Activeds.lib |
| DLL | Activeds.dll |