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

Статья
11/20/2024

Функция DsCrackUnquotedMangledRdn распаковывает (unencodes) заданное относительное различающееся имя и возвращает как декодируемый 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 или Юникод этой функции на основе определения константы препроцессора ЮНИКОД. Сочетание использования псевдонима, нейтрального для кодирования, с кодом, не зависящим от кодирования, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в соглашениях о прототипах функций.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows Vista
минимальный поддерживаемый сервер	Windows Server 2008
целевая платформа	Виндоус
заголовка	dsparse.h (include Ntdsapi.h)
библиотеки	Ntdsapi.lib
DLL	Ntdsapi.dll

См. также

DS_MANGLE_FOR

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

DsIsMangledDn

DsIsMangledRdnValue

DsUnquoteRdnValue

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