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 |