DsGetRdnW 函数 (dsparse.h)

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

输入时包含要分析的可分辨名称字符串的 Unicode 字符串的地址。 此字符串的长度在 pcDN 参数中指定。 如果函数成功，则此参数将调整为指向除当前相对可分辨名称的其余部分。 例如，如果此参数指向字符串“dc=corp，dc=fabrikam，dc=com”，则函数完成后，此参数指向字符串“，dc=fabrikam，dc=com”。

[in, out] pcDN

指向 DWORD 值的指针，该值在输入时包含 ppDN 字符串中的字符数。 如果函数成功，此参数将接收可分辨名称其余部分的字符数。 这些值不包括以 null 结尾的字符。

[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
标头	dsparse.h (包括 Ntdsapi.h)
Library	Ntdsapi.lib
DLL	Ntdsapi.dll

请参阅

域控制器和复制管理功能