Metodo IAccessControl::IsAccessAllowed (iaccess.h)
Determina se il trustee specificato ha diritti di accesso all'oggetto o alla proprietà.
Sintassi
HRESULT IsAccessAllowed(
[in] PTRUSTEEW pTrustee,
[in] LPWSTR lpProperty,
[in] ACCESS_RIGHTS AccessRights,
[out] BOOL *pfAccessAllowed
);
Parametri
[in] pTrustee
Puntatore a una struttura TRUSTEEE .
[in] lpProperty
Nome della proprietà. Se si usa l'implementazione COM di IAccessControl, questo parametro deve essere NULL.
[in] AccessRights
Diritti di accesso sull'oggetto. Se si usa l'implementazione COM di IAccessControl, questo valore deve essere 0 o 1 (COM_RIGHTS_EXECUTE).
[out] pfAccessAllowed
Indica se l'accesso è consentito.
Valore restituito
Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .
Commenti
Nell'implementazione fornita dal sistema di IAccessControl (CLSID_DCOMAccessControl), IsAccessAllowed può essere chiamato solo durante una chiamata COM distribuita e l'unico nome attendibile valido è il nome del client.
Le tabelle seguenti elencano le autorizzazioni di accesso specifiche dell'oggetto usate con l'implementazione del servizio directory e dell'archiviazione di IAccessControl.
Le autorizzazioni seguenti sono specifiche degli oggetti DS.
| Autorizzazione di accesso | Descrizione |
|---|---|
| ACTRL_DS_OPEN | Aprire un oggetto DS |
| ACTRL_DS_CREATE_CHILD | Creare un oggetto figlio |
| ACTRL_DS_DELETE_CHILD | Eliminare un oggetto figlio |
| ACTRL_DS_LIST | Enumerare un oggetto |
| ACTRL_DS_SELF | Aggiornare un elenco di membri che coinvolge il trustee |
| ACTRL_DS_READ_PROP | Leggere le proprietà |
| ACTRL_DS_WRITE_PROP | Proprietà di scrittura |
Le autorizzazioni seguenti sono specifiche per gli oggetti file.
| Autorizzazione di accesso | Descrizione |
|---|---|
| ACTRL_FILE_READ | Legge da un file |
| ACTRL_FILE_WRITE | Scrivere in un file |
| ACTRL_FILE_APPEND | Aggiungere a un file |
| ACTRL_FILE_READ_PROP | Leggere le proprietà dei file o gli attributi estesi |
| ACTRL_FILE_WRITE_PROP | Scrivere proprietà file o attributi estesi |
| ACTRL_FILE_EXECUTE | Eseguire il file |
| ACTRL_FILE_READ_ATTRIB | Leggere gli attributi del file |
| ACTRL_FILE_WRITE_ATTRIB | Scrivere gli attributi del file |
Le autorizzazioni seguenti sono specifiche per gli oggetti directory.
| Autorizzazione di accesso | Descrizione |
|---|---|
| ACTRL_DIR_LIST | Elencare il contenuto di una directory |
| ACTRL_DIR_CREATE_OBJECT | Creare un oggetto figlio (file) in una directory |
| ACTRL_DIR_CREATE_CHILD | Creare una sottodirectory |
| ACTRL_DIR_DELETE_CHILD | Eliminare una sottodirectory |
| ACTRL_DIR_TRAVERSE | Attraversare la directory |
Le autorizzazioni seguenti sono specifiche degli oggetti kernel.
| Autorizzazione di accesso | Descrizione |
|---|---|
| ACTRL_KERNEL_TERMINATE | Terminare un processo o un thread |
| ACTRL_KERNEL_THREAD | Creare un thread |
| ACTRL_KERNEL_VM | Eseguire operazioni sullo spazio indirizzi |
| ACTRL_KERNEL_VM_READ | Lettura dalla memoria |
| ACTRL_KERNEL_VM_WRITE | Scrittura in memoria |
| ACTRL_KERNEL_DUP_HANDLE | Duplicare un handle |
| ACTRL_KERNEL_PROCESS | Creare un processo |
| ACTRL_KERNEL_SET_INFO | Ottenere informazioni sull'oggetto kernel o sullo stato |
| ACTRL_KERNEL_GET_INFO | Impostare informazioni sull'oggetto kernel o sullo stato |
| ACTRL_KERNEL_CONTROL | Controllare un oggetto kernel (ad esempio la sospensione di un thread) |
| ACTRL_KERNEL_ALERT | Avvisare un oggetto kernel. |
| ACTRL_KERNEL_GET_CONTEXT | Ottenere il contesto del thread |
| ACTRL_KERNEL_SET_CONTEXT | Impostare il contesto del thread |
| ACTRL_KERNEL_TOKEN | Impostare il token di thread |
| ACTRL_KERNEL_IMPERSONATE | Rappresentare un client |
| ACTRL_KERNEL_DIMPERSONATE | Rappresentare direttamente un client |
Le autorizzazioni seguenti sono specifiche per gli oggetti stampante.
| Autorizzazione di accesso | Descrizione |
|---|---|
| ACTRL_PRINT_SADMIN | Amministrare un server di stampa |
| ACTRL_PRINT_SLIST | Enumerare un server di stampa |
| ACTRL_PRINT_PADMIN | Amministrare una stampante |
| ACTRL_PRINT_PUSE | Usare una stampante |
| ACTRL_PRINT_JADMIN | Amministrare un processo di stampa |
Le autorizzazioni seguenti sono specifiche per gli oggetti servizio.
| Autorizzazione di accesso | Descrizione |
|---|---|
| ACTRL_SVC_GET_INFO | Avviare un servizio |
| ACTRL_SVC_SET_INFO | Arrestare un servizio |
| ACTRL_SVC_STATUS | Sospendere un servizio |
| ACTRL_SVC_LIST | Enumerare i servizi |
| ACTRL_SVC_START | Avviare un servizio |
| ACTRL_SVC_STOP | Arrestare un servizio |
| ACTRL_SVC_PAUSE | Sospendere un servizio |
| ACTRL_SVC_INTERROGATE | Eseguire una query sul servizio per ottenere lo stato corrente |
| ACTRL_SVC_UCONTROL | Controllo definito dall'utente |
Le autorizzazioni seguenti sono specifiche per gli oggetti del Registro di sistema.
| Autorizzazione di accesso | Descrizione |
|---|---|
| ACTRL_REG_QUERY | Leggere una sottochiave del Registro di sistema |
| ACTRL_REG_SET | Scrivere una sottochiave del Registro di sistema |
| ACTRL_REG_CREATE_CHILD | Creare una sottochiave del Registro di sistema |
| ACTRL_REG_LIST | Enumerare una sottochiave del Registro di sistema |
| ACTRL_REG_NOTIFY | Creare una notifica del Registro di sistema |
| ACTRL_REG_LINK | Creare un collegamento simbolico |
Le autorizzazioni seguenti sono specifiche per gli oggetti finestra.
| Autorizzazione di accesso | Descrizione |
|---|---|
| ACTRL_WIN_CLIPBRD | Abilitare l'accesso agli Appunti |
| ACTRL_WIN_GLOBAL_ATOMS | Abilitare l'accesso global-atom |
| ACTRL_WIN_CREATE | Creare l'accesso desktop |
| ACTRL_WIN_LIST_DESK | Enumerare i desktop |
| ACTRL_WIN_LIST | Enumerare la stazione finestra |
| ACTRL_WIN_READ_ATTRIBS | Leggere gli attributi |
| ACTRL_WIN_WRITE_ATTRIBS | Scrivere gli attributi |
| ACTRL_WIN_SCREEN | Abilitare l'accesso alla schermata |
| ACTRL_WIN_EXIT | Chiamare ExitWindows o ExitWindowsEx |
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows 2000 Professional [solo app desktop] |
| Server minimo supportato | Windows 2000 Server [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | iaccess.h |