Condividi tramite

Funzione DSCreateISecurityInfoObjectEx (dssec.h)

  • Articolo

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

Sintassi

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

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] pwszServer

Server dell'oggetto specificato dal parametro pwszObjectPath . Se il valore di questo parametro è NULL, il server viene ottenuto dal percorso specificato dal parametro pwszObjectPath .

[in] pwszUserName

Nome utente da associare al nuovo oggetto ISecurityInformation . Se il valore di questo parametro è NULL, viene utilizzato il valore predefinito di Active Directory Services Interfaces (ADSI).

[in] pwszPassword

Password da associare al nuovo oggetto ISecurityInformation . Se il valore di questo parametro è NULL, viene utilizzato il valore predefinito di Active Directory Services Interfaces (ADSI).

[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