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

Статья
08/23/2023

Функция DsCrackUnquotedMangledRdn расшифровывает (отменяет код) заданное относительное различающееся имя и возвращает как декодированные GUID, так и используемый тип искажания.

Синтаксис

DSPARSE BOOL DsCrackUnquotedMangledRdnA(
  [in]            LPCSTR        pszRDN,
  [in]            DWORD         cchRDN,
  [out, optional] GUID          *pGuid,
  [out, optional] DS_MANGLE_FOR *peDsMangleFor
);

Параметры

[in] pszRDN

Указатель на строку, содержащую относительное различающееся имя (RDN) для перевода. Эта длина строки задается параметром cchRDN , поэтому для этой строки не требуется завершать значение NULL. Эта строка должна быть в форме без кавов. Дополнительные сведения о несмеченных относительных именах см. в разделе DsUnquoteRdnValue.

[in] cchRDN

Содержит длину строки pszRDN в символах.

[out, optional] pGuid

Указатель на значение GUID , которое получает GUID неуправляемого относительного различающегося имени. Этот параметр может принимать значение NULL.

[out, optional] peDsMangleFor

Указатель на DS_MANGLE_FOR значение, которое получает тип искажания, используемый в искаженном относительном различаемом имени. Этот параметр может принимать значение NULL.

Возвращаемое значение

Эта функция возвращает значение TRUE , если относительное различающееся имя искажено или false в противном случае. Если эта функция возвращает значение FALSE, ни pGuid , ни peDsMangleFor не получают никаких данных.

Эта функция пытается декодировать (расшифровывать) RDN, которое ранее было изменено из-за удаления или конфликта именования. Если относительное различающееся имя искажено, функция возвращает значение TRUE и при запросе извлекает guid и тип управления. Если относительное различающееся имя не искажено, функция возвращает значение FALSE.

Примечание

Заголовок dsparse.h определяет DsCrackUnquotedMangledRdn как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора UNICODE. Сочетание использования псевдонима, не зависящий от кодировки, с кодом, не зависящим от кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.

Требования

Требование	Значение
Минимальная версия клиента	Windows Vista
Минимальная версия сервера	Windows Server 2008
Целевая платформа	Windows
Header	dsparse.h (включая Ntdsapi.h)
Библиотека	Ntdsapi.lib
DLL	Ntdsapi.dll