SecurityDescriptorToBinarySD 函式 (adshlp.h)

發行項
03/05/2024

SecurityDescriptorToBinarySD 函式會將 IADsSecurityDescriptor 物件轉換為二進位安全性描述元格式。

語法

HRESULT SecurityDescriptorToBinarySD(
  [in]  VARIANT              vVarSecDes,
  [out] PSECURITY_DESCRIPTOR *ppSecurityDescriptor,
  [out] PDWORD               pdwSDLength,
  [in]  LPCWSTR              pszServerName,
  [in]  LPCWSTR              userName,
  [in]  LPCWSTR              passWord,
  [in]  DWORD                dwFlags
);

參數

[in] vVarSecDes

類型： VARIANT

包含 VARIANT，其中包含要轉換的安全性描述元。 VARIANT 必須包含包含 IADsSecurityDescriptor 物件的VT_DISPATCH。

[out] ppSecurityDescriptor

類型： PSECURITY_DESCRIPTOR*

接收二進位安全性描述元數據的 SECURITY_DESCRIPTOR 指標位址。呼叫端必須將這個指標傳遞至 FreeADsMem 函式，以釋放此記憶體。

[out] pdwSDLength

類型： PDWORD

接收長度的 DWORD 值位址，以位元組為單位的二進位安全描述元數據。

[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

這個方法支持標準傳回值，以及下列專案。

備註

此函式用於舊版應用程式，以手動將安全性描述元轉換為二進位安全性描述元。針對新的應用程式，請使用 IADsSecurityUtility，以自動執行此轉換。

規格需求

需求	值
最低支援的用戶端	Windows Vista
最低支援的伺服器	Windows Server 2008
目標平台	Windows
標頭	adshlp.h
程式庫	Activeds.lib
Dll	Activeds.dll