DSCreateSecurityPage 函式 (dssec.h)

  • 發行項

DSCreateSecurityPage函式會為 Active Directory 物件建立安全性屬性頁。 產生的屬性頁可以新增至屬性工作表。

語法

HRESULT DSCreateSecurityPage(
  [in]           LPCWSTR                pwszObjectPath,
  [in, optional] LPCWSTR                pwszObjectClass,
  [in]           DWORD                  dwFlags,
  [out]          HPROPSHEETPAGE         *phPage,
  [in, optional] PFNREADOBJECTSECURITY  pfnReadSD,
  [in, optional] PFNWRITEOBJECTSECURITY pfnWriteSD,
  [in]           LPARAM                 lpContext
);

參數

[in] pwszObjectPath

Null終止寬字元字串的指標，表示物件的完整 Active Directory 路徑。

[in, optional] pwszObjectClass

代表物件類別之 Null終止寬字元字串的指標。 此值可以是 Null。

[in] dwFlags

用於安全性屬性頁的旗標。 此參數可以是無或下列旗標的任何組合。

值 意義
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] phPage

HPROPSHEETPAGE的指標，會傳回已建立的安全性屬性頁。

[in, optional] pfnReadSD

用來讀取物件 之安全描述元 之函式的指標。 此值可以是 Null。 如果 pfnReadSD 不是 Null， DSCreateSecurityPage 會呼叫 pfnReadSD 所參考的函式，以擷取物件的安全性描述項。

[in, optional] pfnWriteSD

函式的指標，用來寫入物件的安全性描述元。 此值可以是 Null。 如果 pfnWriteSD 不是 Null， DSCreateSecurityPage 會呼叫 pfnWriteSD 所參考的函式，以寫入物件的安全性描述元。

[in] lpContext

要傳遞至 pfnReadSD 或 pfnWriteSD所識別之函式的內容。

傳回值

如果函式成功，函式會傳回S_OK。

如果函式失敗，它會傳回 指出錯誤的 HRESULT 值。 如需常見錯誤碼的清單，請參閱 一般 HRESULT 值。

備註

pfnReadSD所指向的函式定義如下。

#include <windows.h>

typedef HRESULT (WINAPI *PFNREADOBJECTSECURITY)(
    LPCWSTR,               // Active Directory path of object
    SECURITY_INFORMATION,  // the security information to read
    PSECURITY_DESCRIPTOR*, // the returned security descriptor 
    LPARAM                 // context parameter
);

DSCreateSecurityPage函式會呼叫LocalFree函式，釋放上述第三個參數中傳回的安全性描述元。

pfnWriteSD所指向的函式定義如下。

#include <windows.h>

typedef HRESULT (WINAPI *PFNWRITEOBJECTSECURITY)(
    LPCWSTR,              // Active Directory path of object
    SECURITY_INFORMATION, // the security information to write
    PSECURITY_DESCRIPTOR, // the security descriptor to write
    LPARAM                // context parameter
);

需求

   
最低支援的用戶端 都不支援
最低支援的伺服器 Windows Server 2003 [僅限桌面應用程式]
目標平台 Windows
標頭 dssec.h
程式庫 DSSec.lib
Dll DSSec.dll

另請參閱

基本安全性屬性頁

ISecurityInformation