Funzione DSCreateISecurityInfoObject (dssec.h)

Articolo
08/23/2023

La funzione DSCreateISecurityInfoObject crea un'istanza dell'interfaccia ISecurityInformation associata all'oggetto DS (Directory Service) specificato.

Sintassi

HRESULT DSCreateISecurityInfoObject(
  [in]           LPCWSTR                pwszObjectPath,
  [in]           LPCWSTR                pwszObjectClass,
  [in]           DWORD                  dwFlags,
  [out]          LPSECURITYINFO         *ppSI,
  [in, optional] PFNREADOBJECTSECURITY  pfnReadSD,
  [in, optional] PFNWRITEOBJECTSECURITY pfnWriteSD,
  [in]           LPARAM                 lpContext
);

Parametri

[in] pwszObjectPath

Percorso completo dell'oggetto DS per il quale creare un'istanza dell'interfaccia ISecurityInformation .

[in] pwszObjectClass

Classe dell'oggetto specificato dal parametro pwszObjectPath .

[in] dwFlags

Flag utilizzati per la pagina delle proprietà di sicurezza associata alla nuova istanza dell'interfaccia ISecurityInformation . Questo parametro può essere qualsiasi 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 filtri.
DSSI_NO_READONLY_MESSAGE 0x00000040	Elimina i messaggi popup di sola lettura.

[out] ppSI

Puntatore all'istanza dell'interfaccia ISecurityInformation creata da questa funzione.

[in, optional] pfnReadSD

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

[in, optional] pfnWriteSD

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

[in] lpContext

Contesto da passare alle funzioni identificate dai parametri pfnReadSD e 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 dei codici di errore comuni, vedere Valori HRESULT comuni.

Requisiti


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