Funzione DSCreateSecurityPage (dssec.h)

Articolo
08/23/2023

La funzione DSCreateSecurityPage crea una pagina delle proprietà di sicurezza per un oggetto Active Directory. La pagina delle proprietà risultante può essere aggiunta a un foglio delle proprietà.

Sintassi

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
);

Parametri

[in] pwszObjectPath

Puntatore a una stringa di caratteri wide con terminazione null che rappresenta il percorso completo di Active Directory per l'oggetto.

[in, optional] pwszObjectClass

Puntatore a una stringa di caratteri wide con terminazione null che rappresenta la classe oggetto. Questo valore può essere NULL.

[in] dwFlags

Flag usati per la pagina delle proprietà di sicurezza. Questo parametro può essere nessuna o alcuna combinazione dei flag seguenti.

Valore	Significato
DSSI_READ_ONLY 0x00000001	Le proprietà di sicurezza sono di sola lettura.
DSSI_NO_ACCESS_CHECK 0x00000002	Non viene eseguito alcun controllo di accesso.
DSSI_NO_EDIT_SACL 0x00000004	La proprietà SACL ( System Access Control List ) è di sola lettura.
DSSI_NO_EDIT_OWNER 0x00000008	La proprietà proprietario dell'oggetto è di sola lettura.
DSSI_IS_ROOT 0x00000010	L'oggetto è un oggetto radice.
DSSI_NO_FILTER 0x00000020	Non applicare alcun filtro.
DSSI_NO_READONLY_MESSAGE 0x00000040	Eliminare i messaggi popup di sola lettura.

[out] phPage

Puntatore a HPROPSHEETPAGE che restituisce la pagina delle proprietà di sicurezza creata.

[in, optional] pfnReadSD

Puntatore a una funzione usata per leggere il descrittore di sicurezza dell'oggetto. Questo valore può essere NULL. Se pfnReadSD non è NULL, DSCreateSecurityPage chiama la funzione a cui fa riferimento pfnReadSD per recuperare il descrittore di sicurezza dell'oggetto.

[in, optional] pfnWriteSD

Puntatore a una funzione usata per scrivere il descrittore di sicurezza dell'oggetto. Questo valore può essere NULL. Se pfnWriteSD non è NULL, DSCreateSecurityPage chiama la funzione a cui fa riferimento pfnWriteSD per scrivere il descrittore di sicurezza dell'oggetto.

[in] lpContext

Contesto da passare alle funzioni identificate da pfnReadSD o pfnWriteSD.

Valore restituito

Se la funzione ha esito positivo, la funzione restituisce S_OK.

Se la funzione ha esito negativo, restituisce un valore HRESULT che indica l'errore. Per un elenco di codici di errore comuni, vedere Valori HRESULT comuni.

Commenti

La funzione a cui fa riferimento pfnReadSD è definita come segue.

#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
);

La funzione DSCreateSecurityPage libera il descrittore di sicurezza restituito nel terzo parametro precedente da una chiamata alla funzione LocalFree .

La funzione puntata da pfnWriteSD è definita come segue.

#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
);

Requisiti


Client minimo supportato	Nessuno supportato
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	dssec.h
Libreria	DSSec.lib
DLL	DSSec.dll

Vedi anche

Pagina delle proprietà Di base

ISecurityInformation

Condividi tramite