Функция DsQuoteRdnValueA (dsparse.h)

Статья
08/23/2023

Функция 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 указываются в кавычки в соответствии со спецификацией "Протокол доступа к упрощенным каталогам (версия 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

См. также раздел

Контроллер домена и функции управления репликацией

DsUnquoteRdnValue

Поделиться через