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