Функция DsQuoteRdnValueA (dsparse.h)
Функция DsQuoteRdnValue преобразует RDN в значение RDN в кавычки, если значение RDN содержит символы, требующие кавычек. Затем заключенный в кавычки RDN можно отправить в службу каталогов как часть различающегося имени (DN) с помощью различных API, таких как LDAP. Примером RDN, для которого требуются кавычки, может быть то, что имеет значение, разделенное запятыми, например RDN для имени, в котором используется формат "last,first".
Синтаксис
DSPARSE DWORD DsQuoteRdnValueA(
[in] DWORD cUnquotedRdnValueLength,
[in] LPCCH psUnquotedRdnValue,
[in, out] DWORD *pcQuotedRdnValueLength,
[out] LPCH psQuotedRdnValue
);
Параметры
[in] cUnquotedRdnValueLength
Количество символов в строке psUnquotedRdnValue .
[in] psUnquotedRdnValue
Строка, задающая значение RDN без кавотов.
[in, out] pcQuotedRdnValueLength
Максимальное количество символов в строке psQuotedRdnValue .
Следующие флаги являются выходными данными для этого параметра.
ERROR_SUCCESS
Указывает, что в psQuotedRdnValue найдено правильное количество символов.
ERROR_BUFFER_OVERFLOW
Указывает, что количество символов в строке не соответствует psQuotedRdnValue.
[out] psQuotedRdnValue
Строка, которая получает преобразованное значение RDN и, возможно, в кавычки.
Возвращаемое значение
Следующий список содержит возможные значения, возвращаемые для функции DsQuoteRdnValue .
Комментарии
Кавычки не добавляются в RDN, если они не требуются. В этом случае выходное значение RDN совпадает с входным значением RDN.
При необходимости кавычки RDN указываются в кавычки в соответствии со спецификацией "Протокол доступа к упрощенным каталогам (версия 3): строковое представление различающихся имен в UTF-8" RFC 2253.
Входные и выходные значения RDN не являются строками, завершающиеся null.
Чтобы отменить изменения изменения, внесенные этим вызовом, вызовите функцию DsUnquoteRdnValue.
Примечание
Заголовок dsparse.h определяет DsQuoteRdnValue в качестве псевдонима, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОД. Использование псевдонима, не зависящий от кодирования, с кодом, который не является нейтральным для кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или времени выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.
Требования
| Минимальная версия клиента | Windows Vista |
| Минимальная версия сервера | Windows Server 2008 |
| Целевая платформа | Windows |
| Header | dsparse.h (включая Ntdsapi.h) |
| Библиотека | Ntdsapi.lib |
| DLL | Ntdsapi.dll |