DSCreateISecurityInfoObjectEx 函式 (dssec.h)
DSCreateISecurityInfoObjectEx函式會建立與指定之目錄服務相關聯的ISecurityInformation介面實例, (指定伺服器上的 DS) 物件。
語法
HRESULT DSCreateISecurityInfoObjectEx(
[in] LPCWSTR pwszObjectPath,
[in] LPCWSTR pwszObjectClass,
[in] LPCWSTR pwszServer,
[in] LPCWSTR pwszUserName,
[in] LPCWSTR pwszPassword,
[in] DWORD dwFlags,
[out] LPSECURITYINFO *ppSI,
[in, optional] PFNREADOBJECTSECURITY pfnReadSD,
[in, optional] PFNWRITEOBJECTSECURITY pfnWriteSD,
[in] LPARAM lpContext
);
參數
[in] pwszObjectPath
要為其建立 ISecurityInformation 介面實例之 DS 物件的完整路徑。
[in] pwszObjectClass
pwszObjectPath參數所指定的物件類別。
[in] pwszServer
pwszObjectPath參數所指定物件的伺服器。 如果此參數的值是 Null,則會從 pwszObjectPath 參數所指定的路徑取得伺服器。
[in] pwszUserName
要與新 ISecurityInformation 物件相關聯的使用者名稱。 如果此參數的值是 Null,則會使用 ACTIVE Directory Services Interface (ADSI) 預設值。
[in] pwszPassword
要與新 ISecurityInformation 物件相關聯的密碼。 如果此參數的值是 Null,則會使用 ACTIVE Directory Services Interface (ADSI) 預設值。
[in] dwFlags
用於與 ISecurityInformation 介面新實例相關聯之安全性屬性頁的旗標。 此參數可以是下列旗標的任何組合。
值 | 意義 |
---|---|
|
安全性屬性是唯讀的。 |
|
不會執行存取檢查。 |
|
SACL) 屬性 (系統存取控制清單 是唯讀的。 |
|
物件擁有者屬性是唯讀的。 |
|
物件是根物件。 |
|
請勿套用任何篩選。 |
|
隱藏唯讀快顯訊息。 |
[out] ppSI
這個函式所建立之 ISecurityInformation 介面實例的指標。
[in, optional] pfnReadSD
用來讀取物件 之安全描述元 之函式的指標。 此值可以是 Null。 如果 pfnReadSD 不是 Null, DSCreateISecurityInfoObject 會呼叫 pfnReadSD 所參考的函式,以擷取物件的安全性描述元。
[in, optional] pfnWriteSD
函式的指標,用來寫入物件的安全性描述元。 此值可以是 Null。 如果 pfnWriteSD 不是 Null, DSCreateISecurityInfoObject 會呼叫 pfnWriteSD 所參考的函式,以寫入物件的安全性描述元。
[in] lpContext
要傳遞至 pfnReadSD 和 pfnWriteSD 參數所識別之函式的內容。
傳回值
如果函式成功,函式會傳回S_OK。
如果函式失敗,它會傳回 指出錯誤的 HRESULT 值。 如需常見錯誤碼的清單,請參閱 一般 HRESULT 值。
需求
最低支援的用戶端 | 都不支援 |
最低支援的伺服器 | Windows Server 2008 [僅限傳統型應用程式] |
目標平台 | Windows |
標頭 | dssec.h |
程式庫 | DSSec.lib |
Dll | DSSec.dll |