DsCrackUnquotedMangledRdnA 函式（dsarse.h）

發行項
11/20/2024

DsCrackUnquotedMangledRdn 函式 unmangles （unencodes）指定的相對辨別名稱，並傳回已譯碼的 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。

傳回值

如果相對辨別名稱已滿或 FALSE，則此函式會傳回 true TRUE 否則為 FALSE。如果此函式傳回 FALSE，則 pGuid 或 peDsMangleFor 都不會接收任何數據。

言論

此函式會嘗試譯碼先前因刪除或命名衝突而遭到破壞的 RDN。如果相對辨別名稱已滿，則函式會傳回 TRUE，並在要求時擷取 GUID 和 Mangle 類型。如果相對辨別名稱未滿，函式會傳回 FALSE。

注意

dsparse.h 標頭會根據 UNICODE 預處理器常數的定義，將 DsCrackUnquotedMangledRdn 定義為自動選取此函式的 ANSI 或 Unicode 版本。混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。如需詳細資訊，請參閱函式原型的慣例。

要求

要求	價值
最低支援的用戶端	Windows Vista
支援的最低伺服器	Windows Server 2008
目標平臺	窗戶
標頭	dsparse.h （包括 Ntdsapi.h）
連結庫	Ntdsapi.lib
DLL	Ntdsapi.dll