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


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

Функция 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

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

DS_MANGLE_FOR

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

DsIsMangledDn

DsIsMangledRdnValue

DsUnquoteRdnValue