Функция 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 цитируется в соответствии со спецификацией "Упрощенный протокол доступа к каталогам (v3): строковое представление различаемых имен UTF-8", RFC 2253.
Входные и выходные значения RDN не null-terminated strings.
Чтобы вернуть изменения, внесенные этим вызовом, вызовите функцию DsUnquoteRdnValue.
Заметка
Заголовок dsparse.h определяет DsQuoteRdnValue как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОДа. Сочетание использования псевдонима, нейтрального для кодирования, с кодом, не зависящим от кодирования, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в соглашениях о прототипах функций.
Требования
| Требование | Ценность |
|---|---|
| минимальные поддерживаемые клиентские | Windows Vista |
| минимальный поддерживаемый сервер | Windows Server 2008 |
| целевая платформа | Виндоус |
| заголовка | dsparse.h (include Ntdsapi.h) |
| библиотеки |
Ntdsapi.lib |
| DLL | Ntdsapi.dll |