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

Статья
08/23/2023

Функция DsGetRdnW извлекает ключ и значение первого относительного различающегося имени и указатель на следующее относительное различающееся имя из строки различающегося имени.

Синтаксис

DSPARSE DWORD DsGetRdnW(
  [in, out] LPCWCH *ppDN,
  [in, out] DWORD  *pcDN,
  [out]     LPCWCH *ppKey,
  [out]     DWORD  *pcKey,
  [out]     LPCWCH *ppVal,
  [out]     DWORD  *pcVal
);

Параметры

[in, out] ppDN

Адрес указателя строки Юникода, который при входе содержит различающуюся строку имени для анализа. Длина этой строки указывается в параметре pcDN . Если функция завершается успешно, этот параметр настраивается таким образом, чтобы он указывал на оставшуюся часть различающегося имени, за исключением текущего относительного различающегося имени. Например, если этот параметр указывает на строку "dc=corp,dc=fabrikam,dc=com", то после завершения функции этот параметр указывает на строку ",dc=fabrikam,dc=com".

[in, out] pcDN

Указатель на значение DWORD , которое в записи содержит количество символов в строке ppDN . Если функция выполняется успешно, этот параметр получает количество символов в оставшейся части различающегося имени. Эти значения не включают символ, завершающийся нулевым значением.

[out] ppKey

Указатель на значение LPCWCH , которое при успешном выполнении функции получает указатель на ключ в строке относительного различающегося имени. Этот указатель находится в строке ppDN и не завершается null. Параметр pcKey получает количество символов в ключе. Этот параметр не определен, если pcKey получает ноль.

[out] pcKey

Указатель на значение DWORD , которое при успешном выполнении функции получает количество символов в ключевой строке, представленной параметром ppKey . Если этот параметр получает ноль, ppKey не определен.

[out] ppVal

Указатель на значение LPCWCH , которое в случае успешного выполнения функции получает указатель на значение в строке относительного различающегося имени. Этот указатель находится в строке ppDN и не завершается null. Параметр pcVal получает количество символов в значении. Этот параметр не определен, если pcVal получает ноль.

[out] pcVal

Указатель на значение DWORD , которое при успешном выполнении функции получает количество символов в строке значения, представленной параметром ppVal . Если этот параметр получает ноль, значение ppVal не определено.

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

Возвращает ERROR_SUCCESS в случае успешного выполнения или код ошибки Win32 в противном случае. Возможные коды ошибок включают следующие значения.

Требования


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

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

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

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