DsCrackUnquotedMangledRdnA 函式 (dsparse.h)

  • 發行項

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。

傳回值

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

備註

此函式會嘗試譯碼 (unmangle) 先前因刪除或命名衝突而遭到管理 RDN。 如果相對辨別名稱受到管理，則函式會傳回 TRUE ，並在要求時擷取 GUID 和 mangle 類型。 如果相對辨別名稱未受到管理，函式會傳回 FALSE。

注意

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

規格需求

需求 值
最低支援的用戶端 Windows Vista
最低支援的伺服器 Windows Server 2008
目標平台 Windows
標頭 dsparse.h (包含 Ntdsapi.h)
程式庫 Ntdsapi.lib
Dll Ntdsapi.dll

另請參閱

DS_MANGLE_FOR

域控制器和復寫管理功能

DsIsMangledDn

DsIsMangledRdnValue

DsUnquoteRdnValue