binarySDToSecurityDescriptor 函式 (adshlp.h)
BinarySDToSecurityDescriptor 函式會將二進位安全性描述元轉換為 IADsSecurityDescriptor 物件。
語法
HRESULT BinarySDToSecurityDescriptor(
[in] PSECURITY_DESCRIPTOR pSecurityDescriptor,
[out] VARIANT *pVarsec,
[in] LPCWSTR pszServerName,
[in] LPCWSTR userName,
[in] LPCWSTR passWord,
[in] DWORD dwFlags
);
參數
[in] pSecurityDescriptor
類型： PSECURITY_DESCRIPTOR
要轉換之 SECURITY_DESCRIPTOR 結構的位址。
[out] pVarsec
類型： VARIANT*
接收物件的 VARIANT 位址。 VARIANT 包含可查詢 IADsSecurityDescriptor 介面的 VT_DISPATCH 物件。 呼叫端必須將 VARIANT 傳遞至 VariantClear 函式，以釋放此 VARIANT。
[in] pszServerName
類型： LPCWSTR
Null 終止的 Unicode 字串，提供從中擷取安全描述項的伺服器名稱。 這個參數是選擇性的，而且可以是 NULL。
[in] userName
類型： LPCWSTR
以 Null 結尾的 Unicode 字串，提供要與安全性描述元相關聯的用戶名稱。 這個參數是選擇性的，而且可以是 NULL。
[in] passWord
類型： LPCWSTR
以 Null 終止的 Unicode 字串，提供要與安全性描述元相關聯的密碼。 這個參數是選擇性的，而且可以是 NULL。
[in] dwFlags
類型： DWORD
包含轉換的驗證旗標。 這可以是零或一或多個 ADS_AUTHENTICATION_ENUM 列舉值的組合。
傳回值
類型： HRESULT
這個方法支持標準傳回值，以及下列專案：
如果作業失敗，則會傳回 ADSI 錯誤碼。 如需詳細資訊，請參閱 ADSI 錯誤碼。
備註
此函式用於必須手動將安全性描述元轉換為二進位安全性描述元的舊版應用程式。 針對新的應用程式，請使用會自動進行這項轉換的 IADsSecurityUtility 介面。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows Vista |
| 最低支援的伺服器 | Windows Server 2008 |
| 目標平台 | Windows |
| 標頭 | adshlp.h |
| 程式庫 | Activeds.lib |
| Dll | Activeds.dll |