Metodo ISecurityInformation4::GetSecondarySecurity (aclui.h)

Il metodo GetSecondarySecurity restituisce contesti di sicurezza aggiuntivi che potrebbero influire sull'accesso alla risorsa.

Sintassi

HRESULT GetSecondarySecurity(
  [out] PSECURITY_OBJECT *pSecurityObjects,
  [out] PULONG           pSecurityObjectCount
);

Parametri

[out] pSecurityObjects

Matrice di strutture SECURITY_OBJECT che contengono gli oggetti di sicurezza secondari associati alle risorse impostate in caso di esito positivo. La matrice è di proprietà del chiamante e viene liberata tramite la funzione LocalFree . Il membro pwszName viene liberato anche tramite LocalFree. Se i membri cbData o cbData2 della struttura SECURITY_OBJECT non sono zero, il chiamante deve liberare il pData o pData2 corrispondente usando LocalFree. Se uno di questi membri è zero, i membri pData e pData2 corrispondenti sono di proprietà del gestore risorse e devono rimanere validi fino a quando la funzione EditSecurity non restituisce

[out] pSecurityObjectCount

Numero di oggetti di sicurezza nel parametro pSecurityObjects impostati in caso di esito positivo.

Valore restituito

Se il metodo ha esito positivo, restituisce S_OK.

Se il metodo ha esito negativo, viene restituito un codice errore. Per un elenco dei codici di errore comuni, vedere Valori HRESULT comuni.

Commenti

Un gestore risorse non deve restituire oggetti secondari con il membro fWellKnown impostato su TRUE e il membro Id impostato su SECURITY_OBJECT_ID_OBJECT_SD, SECURITY_OBJECT_ID_CENTRAL_POLICY o SECURITY_OBJECT_ID_CENTRAL_ACCESS_RULE. Gli oggetti di sicurezza con questi ID verranno forniti dall'editor di controllo di accesso quando si chiama ComputeEffectivePermissionWithSecondarySecurity.

L'interpretazione degli oggetti di sicurezza restituiti è associata all'implementazione di ComputeEffectivePermissionWithSecondarySecurity.

Requisiti

Vedi anche

ISecurityInformation4