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 介面新實例相關聯之安全性屬性頁的旗標。 此參數可以是下列旗標的任何組合。

值 意義
DSSI_READ_ONLY
0x00000001
 安全性屬性是唯讀的。
DSSI_NO_ACCESS_CHECK
0x00000002
 不會執行存取檢查。
DSSI_NO_EDIT_SACL
0x00000004
 SACL) 屬性 (系統存取控制清單 是唯讀的。
DSSI_NO_EDIT_OWNER
0x00000008
 物件擁有者屬性是唯讀的。
DSSI_IS_ROOT
0x00000010
 物件是根物件。
DSSI_NO_FILTER
0x00000020
 請勿套用任何篩選。
DSSI_NO_READONLY_MESSAGE
0x00000040
 隱藏唯讀快顯訊息。

[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