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
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows 8 [solo app desktop] |
| Server minimo supportato | Windows Server 2012 [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | aclui.h |