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 。

傳回值

如果成功或 Win32 錯誤碼，則傳回 ERROR_SUCCESS 。否則傳回 。 可能的錯誤碼包括下列值。

需求

另請參閱

網域控制站和複寫管理功能