Funzione DSCreateISecurityInfoObject (dssec.h)

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.

[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