Questo articolo è stato tradotto automaticamente. Per visualizzare l'articolo in inglese, selezionare la casella di controllo Inglese. È possibile anche visualizzare il testo inglese in una finestra popup posizionando il puntatore del mouse sopra il testo.
Traduzione
Inglese

Metodo MessageQueue.SetPermissions (String, MessageQueueAccessRights)

 

Data di pubblicazione: ottobre 2016

Fornisce un computer, gruppo o utente i diritti di accesso specificato.

Spazio dei nomi:   System.Messaging
Assembly:  System.Messaging (in System.Messaging.dll)

public void SetPermissions(
	string user,
	MessageQueueAccessRights rights
)

Parametri

user
Type: System.String

L'individuo, gruppo o computer che ottiene ulteriori diritti per la coda.

rights
Type: System.Messaging.MessageQueueAccessRights

Un MessageQueueAccessRights che indica il set di diritti alla coda di Accodamento messaggi assegna il user passato.

Exception Condition
ArgumentException

L'elemento user è null.

MessageQueueException

Si è verificato un errore quando si accede a un metodo di Accodamento messaggi.

Utilizzare questo overload per concedere i diritti specificati per un singolo utente. L'utente può essere qualsiasi trustee valido, che include i singoli utenti, gruppi di utenti o un computer. Se l'utente è un singolo, utilizzare il formato DOMAIN\user per il user parametro. È possibile specificare "." per il user parametro per indicare il computer locale.

Le autorizzazioni assegnate mediante SetPermissions aggiungere diritti per l'elenco esistente. Per impostazione predefinita, l'autore di una coda pubblica o privata abbia il pieno controllo e il gruppo Everyone dispone dell'autorizzazione per ottenere le proprietà della coda, ottenere le autorizzazioni e scrivere nella coda. Quando si chiama SetPermissions, le informazioni utente e le autorizzazioni vengono aggiunte alla fine dell'elenco esistente.

Il sistema esamina ciascuna AccessControlEntry in sequenza fino a quando non si verifica uno dei seguenti eventi:

  • Un accesso negato AccessControlEntry Nega in modo esplicito i diritti di accesso richiesto a uno dei fiduciari elencati nel token di accesso del thread.

  • Uno o più Autorizzazione di accesso AccessControlEntry voci per tutti i diritti di accesso richiesto di concedere trustee elencati nel token di accesso del thread in modo esplicito.

  • Tutti AccessControlEntry articoli sono stati verificati ed è ancora almeno un diritto di accesso che non è stato esplicitamente concesso, nel qual caso, l'accesso viene implicitamente negato.

I diritti per una coda, specificati nel rights parametro, può essere qualsiasi combinazione dei valori seguenti:

  • Controllo completo

  • Eliminazione di un messaggio

  • Ricezione messaggio

  • Visualizza messaggio

  • Ricevi messaggio Journal

  • Ottenere le proprietà della coda

  • Impostare le proprietà della coda

  • Ottenere le autorizzazioni

  • Impostare le autorizzazioni

  • Diventare proprietario della coda

  • Scrittura di messaggi

Il MessageQueueAccessRights enumerazione rappresenta un set di flag di bit che possono essere combinati utilizzando l'operatore OR bit per bit o per compilare il rights parametro.

Con questo overload, è possibile concedere solo autorizzazioni. non è possibile revocare o negare loro. È necessario utilizzare un altro overload per concedere in modo esplicito qualsiasi AccessControlEntryType diverso da Allow.

Nella tabella seguente indica se questo metodo è disponibile in diverse modalità gruppo di lavoro.

Modalità gruppo di lavoro

Disponibile

Computer locale

Computer locale e il nome di formato direct

Computer remoto

No

Computer remoto e il nome di formato direct

No

L'esempio di codice seguente illustra l'uso di SetPermissions(String, MessageQueueAccessRights).


// Connect to a queue on the local computer.
MessageQueue queue = new MessageQueue(".\\exampleQueue");

// Grant all users in the "Everyone" user group the right to receive
// messages from the queue.
queue.SetPermissions("Everyone", MessageQueueAccessRights.ReceiveMessage);

.NET Framework
Disponibile da 1.1
Torna all'inizio
Mostra: