MessageQueue.SetPermissions MessageQueue.SetPermissions MessageQueue.SetPermissions MessageQueue.SetPermissions Method

Definizione

Aggiunge le autorizzazioni al set di autorizzazioni corrente.Adds permissions to the current set. Controlla gli utenti che dispongono dei diritti di accesso alle proprietà della coda e ai messaggi presenti nella coda.This controls who has access rights to queue properties and messages in the queue.

Overload

SetPermissions(AccessControlList) SetPermissions(AccessControlList) SetPermissions(AccessControlList) SetPermissions(AccessControlList)

Assegna i diritti di accesso alla coda in base al contenuto di un elenco di controllo di accesso.Assigns access rights to the queue based on the contents of an access control list.

SetPermissions(MessageQueueAccessControlEntry) SetPermissions(MessageQueueAccessControlEntry) SetPermissions(MessageQueueAccessControlEntry) SetPermissions(MessageQueueAccessControlEntry)

Assegna i diritti di accesso alla coda in base al contenuto di una voce di controllo di accesso.Assigns access rights to the queue based on the contents of an access control entry.

SetPermissions(String, MessageQueueAccessRights) SetPermissions(String, MessageQueueAccessRights) SetPermissions(String, MessageQueueAccessRights) SetPermissions(String, MessageQueueAccessRights)

Fornisce a un computer, a un gruppo o a un utente i diritti di accesso specificati.Gives a computer, group, or user the specified access rights.

SetPermissions(String, MessageQueueAccessRights, AccessControlEntryType) SetPermissions(String, MessageQueueAccessRights, AccessControlEntryType) SetPermissions(String, MessageQueueAccessRights, AccessControlEntryType) SetPermissions(String, MessageQueueAccessRights, AccessControlEntryType)

Concede a un computer, a un utente o a un gruppo di utenti i diritti di accesso specificati con il tipo di controllo di accesso specificato (concessione, rifiuto, revoca o impostazione).Gives a computer, group, or user the specified access rights, with the specified access control type (allow, deny, revoke, or set).

SetPermissions(AccessControlList) SetPermissions(AccessControlList) SetPermissions(AccessControlList) SetPermissions(AccessControlList)

Assegna i diritti di accesso alla coda in base al contenuto di un elenco di controllo di accesso.Assigns access rights to the queue based on the contents of an access control list.

public:
 void SetPermissions(System::Messaging::AccessControlList ^ dacl);
public void SetPermissions (System.Messaging.AccessControlList dacl);
member this.SetPermissions : System.Messaging.AccessControlList -> unit
Public Sub SetPermissions (dacl As AccessControlList)

Parametri

dacl
AccessControlList AccessControlList AccessControlList AccessControlList

Oggetto AccessControlList contenente una o più voci di controllo di accesso che specificano le terze parti trusted e le autorizzazioni da concedere.A AccessControlList that contains one or more access control entries that specify the trustees and the permissions to grant.

Eccezioni

Si è verificato un errore durante l'accesso a un metodo di Accodamento messaggi.An error occurred when accessing a Message Queuing method.

Esempi

L'esempio di codice seguente illustra l'uso di SetPermissions(AccessControlList).The following code example demonstrates the use of SetPermissions(AccessControlList).


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

// Create an AccessControlList.
AccessControlList^ list = gcnew AccessControlList();

// Create a new trustee to represent the "Everyone" user group.
Trustee^ tr = gcnew Trustee("Everyone");

// Create an AccessControlEntry, granting the trustee read access to
// the queue.
AccessControlEntry^ entry = gcnew AccessControlEntry(
    tr, GenericAccessRights::Read,
    StandardAccessRights::Read,
    AccessControlEntryType::Allow);

// Add the AccessControlEntry to the AccessControlList.
list->Add(entry);

// Apply the AccessControlList to the queue.
queue->SetPermissions(list);

queue->Close();


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

// Create an AccessControlList.
AccessControlList list = new AccessControlList();

// Create a new trustee to represent the "Everyone" user group.
Trustee tr = new Trustee("Everyone");

// Create an AccessControlEntry, granting the trustee read access to
// the queue.
AccessControlEntry entry = new AccessControlEntry(
    tr, GenericAccessRights.Read,
    StandardAccessRights.Read,
    AccessControlEntryType.Allow);

// Add the AccessControlEntry to the AccessControlList.
list.Add(entry);

// Apply the AccessControlList to the queue.
queue.SetPermissions(list);

Commenti

Utilizzare questo overload per concedere, negare o revocare i diritti di utilizzando una raccolta di voci di controllo di accesso per specificare le informazioni di trustee e le autorizzazioni.Use this overload to grant, deny, or revoke rights by using a collection of access control entries to specify trustee and permissions information. Ciò consente, ad esempio, concedere autorizzazioni a più utenti contemporaneamente.This is used, for example, to grant permissions to multiple users at the same time.

Il fiduciario specificato quando si costruisce la ace parametro può essere un singolo utente, un gruppo di utenti o un computer.The trustee you specify when you construct the ace parameter can be an individual user, a group of users, or a computer. Se il fiduciario è un singolo utente, usare il formato DOMAIN \ user.If the trustee is an individual, use the format DOMAIN\user. È possibile specificare "." per il dominio trusted indicare il computer locale.You can specify "." for the trustee to indicate the local computer.

Le autorizzazioni assegnate tramite SetPermissions aggiungere le autorizzazioni per l'elenco esistente.The permissions you assign through SetPermissions add rights to the existing list. Per impostazione predefinita, l'autore di una coda pubblica o privata abbia il pieno controllo e il gruppo di dominio Everyone dispone dell'autorizzazione per ottenere le proprietà della coda, ottenere le autorizzazioni e scrivere nella coda.By default, the creator of a public or private queue has full control, and the domain group Everyone has permission to get queue properties, get permissions, and write to the queue. Quando si chiama SetPermissions, le informazioni utente e le autorizzazioni vengono aggiunte alla fine dell'elenco esistente.When you call SetPermissions, the user and permissions information is appended to the bottom of the existing list.

Il sistema esamina ciascuna AccessControlEntry in sequenza fino a quando non si verifica uno degli eventi seguenti:The system examines each AccessControlEntry in sequence until one of the following events occurs:

  • Un accesso negato AccessControlEntry nega in modo esplicito uno qualsiasi dei diritti di accesso richiesto a una delle fiduciari elencati nel token di accesso del thread.An access-denied AccessControlEntry explicitly denies any of the requested access rights to one of the trustees listed in the thread's access token.

  • Uno o più Autorizzazione dell'accesso AccessControlEntry elementi per tutti i diritti di accesso richiesto di concessione fiduciari elencati nel token di accesso del thread in modo esplicito.One or more access-allowed AccessControlEntry items for trustees listed in the thread's access token explicitly grant all the requested access rights.

  • Tutti i AccessControlEntry articoli sono stati verificati e vi è ancora presente almeno un diritto di accesso che non è stato esplicitamente concesso, nel qual caso, l'accesso viene implicitamente negato.All AccessControlEntry items have been checked and there is still at least one requested access right that has not been explicitly allowed, in which case, access is implicitly denied.

Quando si costruisce il dacl parametro, si aggiungono AccessControlEntry alle istanze di AccessControlList raccolta.When you construct the dacl parameter, you add AccessControlEntry instances to your AccessControlList collection. Quando si crea ogni voce di controllo di accesso, è possibile specificare i diritti di accesso generici o standard.When you construct each access control entry, you can specify generic or standard access rights. I diritti a una coda possono essere qualsiasi combinazione delle operazioni seguenti:The rights to a queue can be any combination of the following:

  • EliminareDelete

  • Sicurezza da letturaRead Security

  • Protezione da scritturaWrite Security

  • SincronizzareSynchronize

  • Modifica proprietarioModify Owner

  • LetturaRead

  • WriteWrite

  • EseguiExecute

  • ObbligatorioRequired

  • TuttiAll

  • nessunoNone

Tali diritti sono un set di flag di bit che è possibile combinare utilizzando l'operatore OR bit per bit.These rights are a set of bit flags that you can combine using the OR bitwise operator.

  • Controllo completoFull Control

  • Eliminare messaggioDelete Message

  • Ricezione messaggioReceive Message

  • Visualizza il messaggioPeek Message

  • Ricevi messaggio JournalReceive Journal Message

  • Ottenere le proprietà della codaGet Queue Properties

  • Impostare le proprietà della codaSet Queue Properties

  • Ottenere le autorizzazioniGet Permissions

  • Impostare le autorizzazioniSet Permissions

  • Assumere la proprietà di codaTake Queue Ownership

  • WriteMessageWrite Message

Nella tabella seguente indica se questo metodo è disponibile in varie modalità gruppo di lavoro.The following table shows whether this method is available in various Workgroup modes.

Modalità gruppo di lavoroWorkgroup mode DisponibileAvailable
Computer localeLocal computer Yes
Computer locale e il nome di formato directLocal computer and direct format name Yes
Computer remotoRemote computer NoNo
Computer remoto e il nome di formato directRemote computer and direct format name NoNo
Vedi anche

SetPermissions(MessageQueueAccessControlEntry) SetPermissions(MessageQueueAccessControlEntry) SetPermissions(MessageQueueAccessControlEntry) SetPermissions(MessageQueueAccessControlEntry)

Assegna i diritti di accesso alla coda in base al contenuto di una voce di controllo di accesso.Assigns access rights to the queue based on the contents of an access control entry.

public:
 void SetPermissions(System::Messaging::MessageQueueAccessControlEntry ^ ace);
public void SetPermissions (System.Messaging.MessageQueueAccessControlEntry ace);
member this.SetPermissions : System.Messaging.MessageQueueAccessControlEntry -> unit
Public Sub SetPermissions (ace As MessageQueueAccessControlEntry)

Parametri

ace
MessageQueueAccessControlEntry MessageQueueAccessControlEntry MessageQueueAccessControlEntry MessageQueueAccessControlEntry

Oggetto MessageQueueAccessControlEntry che specifica un utente, un tipo di accesso e un tipo di autorizzazione.A MessageQueueAccessControlEntry that specifies a user, an access type, and a permission type.

Eccezioni

Si è verificato un errore durante l'accesso a un metodo di Accodamento messaggi.An error occurred when accessing a Message Queuing method.

Esempi

L'esempio di codice seguente illustra l'uso di SetPermissions(MessageQueueAccessControlEntry).The following code example demonstrates the use of SetPermissions(MessageQueueAccessControlEntry).


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

// Create a new trustee to represent the "Everyone" user group.
Trustee^ tr = gcnew Trustee("Everyone");

// Create a MessageQueueAccessControlEntry, granting the trustee the
// right to receive messages from the queue.
MessageQueueAccessControlEntry^ entry = gcnew
    MessageQueueAccessControlEntry(
    tr, MessageQueueAccessRights::ReceiveMessage,
    AccessControlEntryType::Allow);

// Apply the MessageQueueAccessControlEntry to the queue.
queue->SetPermissions(entry);

queue->Close();


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

// Create a new trustee to represent the "Everyone" user group.
Trustee tr = new Trustee("Everyone");

// Create a MessageQueueAccessControlEntry, granting the trustee the
// right to receive messages from the queue.
MessageQueueAccessControlEntry entry = new
    MessageQueueAccessControlEntry(
    tr, MessageQueueAccessRights.ReceiveMessage,
    AccessControlEntryType.Allow);

// Apply the MessageQueueAccessControlEntry to the queue.
queue.SetPermissions(entry);

Commenti

Utilizzare questo overload per concedere, negare o revocare i diritti tramite una voce di controllo di accesso per specificare le informazioni sui diritti e fiduciario.Use this overload to grant, deny, or revoke rights by using an access control entry to specify trustee and rights information.

Il fiduciario specificato quando si costruisce la ace parametro può essere un singolo utente, un gruppo di utenti o un computer.The trustee you specify when you construct the ace parameter can be an individual user, a group of users, or a computer. Se il fiduciario è un singolo utente, usare il formato DOMAIN \ user.If the trustee is an individual, use the format DOMAIN\user. È possibile specificare "." per il dominio trusted indicare il computer locale.You can specify "." for the trustee to indicate the local computer.

Le autorizzazioni assegnate tramite SetPermissions aggiungere le autorizzazioni per l'elenco esistente.The permissions you assign through SetPermissions add rights to the existing list. Per impostazione predefinita, l'autore di una coda pubblica o privata abbia il pieno controllo e il gruppo di dominio Everyone dispone dell'autorizzazione per ottenere le proprietà della coda, ottenere le autorizzazioni e scrivere nella coda.By default, the creator of a public or private queue has full control, and the domain group Everyone has permission to get queue properties, get permissions, and write to the queue. Quando si chiama SetPermissions, le informazioni utente e le autorizzazioni vengono aggiunte alla fine dell'elenco esistente.When you call SetPermissions, the user and permissions information is appended to the bottom of the existing list.

Il sistema esamina ciascuna AccessControlEntry in sequenza fino a quando non si verifica uno degli eventi seguenti:The system examines each AccessControlEntry in sequence until one of the following events occurs:

  • Un accesso negato AccessControlEntry nega in modo esplicito uno qualsiasi dei diritti di accesso richiesto a una delle fiduciari elencati nel token di accesso del thread.An access-denied AccessControlEntry explicitly denies any of the requested access rights to one of the trustees listed in the thread's access token.

  • Uno o più Autorizzazione dell'accesso AccessControlEntry elementi per tutti i diritti di accesso richiesto di concessione fiduciari elencati nel token di accesso del thread in modo esplicito.One or more access-allowed AccessControlEntry items for trustees listed in the thread's access token explicitly grant all the requested access rights.

  • Tutti i AccessControlEntry articoli sono stati verificati e vi è ancora presente almeno un diritto di accesso che non è stato esplicitamente concesso, nel qual caso, l'accesso viene implicitamente negato.All AccessControlEntry items have been checked and there is still at least one requested access right that has not been explicitly allowed, in which case, access is implicitly denied.

I diritti a una coda, specificata nella rights parametro quando si costruisce il MessageQueueAccessControlEntry, può essere qualsiasi combinazione delle opzioni seguenti:The rights to a queue, which you specify in the rights parameter when you construct your MessageQueueAccessControlEntry, can be any combination of the following:

  • Controllo completoFull Control

  • Eliminare messaggioDelete Message

  • Ricezione messaggioReceive Message

  • Visualizza il messaggioPeek Message

  • Ricevi messaggio JournalReceive Journal Message

  • Ottenere le proprietà della codaGet Queue Properties

  • Impostare le proprietà della codaSet Queue Properties

  • Ottenere le autorizzazioniGet Permissions

  • Impostare le autorizzazioniSet Permissions

  • Assumere la proprietà di codaTake Queue Ownership

  • WriteMessageWrite Message

Il rights parametro specificato nel costruttore per il ace parametro è un flag del MessageQueueAccessRights enumerazione.The rights parameter you specify in the constructor for the ace parameter is a flag of the MessageQueueAccessRights enumeration. Rappresenta un set di flag di bit che è possibile combinare l'uso dell'operatore OR bit per bit o quando si compila il rights parametro.It represents a set of bit flags that you can combine using the bitwise operator OR when you build the rights parameter.

Nella tabella seguente indica se questo metodo è disponibile in varie modalità gruppo di lavoro.The following table shows whether this method is available in various Workgroup modes.

Modalità gruppo di lavoroWorkgroup mode DisponibileAvailable
Computer localeLocal computer Yes
Computer locale e il nome di formato directLocal computer and direct format name Yes
Computer remotoRemote computer NoNo
Computer remoto e il nome di formato directRemote computer and direct format name NoNo
Vedi anche

SetPermissions(String, MessageQueueAccessRights) SetPermissions(String, MessageQueueAccessRights) SetPermissions(String, MessageQueueAccessRights) SetPermissions(String, MessageQueueAccessRights)

Fornisce a un computer, a un gruppo o a un utente i diritti di accesso specificati.Gives a computer, group, or user the specified access rights.

public:
 void SetPermissions(System::String ^ user, System::Messaging::MessageQueueAccessRights rights);
public void SetPermissions (string user, System.Messaging.MessageQueueAccessRights rights);
member this.SetPermissions : string * System.Messaging.MessageQueueAccessRights -> unit
Public Sub SetPermissions (user As String, rights As MessageQueueAccessRights)

Parametri

user
String String String String

Singolo utente, gruppo o computer che ottiene ulteriori diritti per la coda.The individual, group, or computer that gets additional rights to the queue.

rights
MessageQueueAccessRights MessageQueueAccessRights MessageQueueAccessRights MessageQueueAccessRights

Oggetto MessageQueueAccessRights che indica una serie di diritti per la coda assegnati da Accodamento messaggi al parametro user passato.A MessageQueueAccessRights that indicates the set of rights to the queue that Message Queuing assigns to the user passed in.

Eccezioni

L'elemento user è null.The user is null.

Si è verificato un errore durante l'accesso a un metodo di Accodamento messaggi.An error occurred when accessing a Message Queuing method.

Esempi

L'esempio di codice seguente illustra l'uso di SetPermissions(String, MessageQueueAccessRights).The following code example demonstrates the use of SetPermissions(String, MessageQueueAccessRights).


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

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

queue->Close();


// 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);

Commenti

Utilizzare questo overload per concedere i diritti specificati per un singolo utente.Use this overload to grant specified rights to an individual user. L'utente può essere qualsiasi fiduciario valido, che include i singoli utenti, gruppi di utenti o un computer.The user can be any valid trustee, which includes individual users, groups of users, or a computer. Se l'utente è una persona, usare il formato DOMAIN \ user per il user parametro.If the user is an individual, use the format DOMAIN\user for the user parameter. È possibile specificare "." per il user parametro per indicare il computer locale.You can specify "." for the user parameter to indicate the local computer.

Le autorizzazioni assegnate tramite SetPermissions aggiungere le autorizzazioni per l'elenco esistente.The permissions you assign through SetPermissions add rights to the existing list. Per impostazione predefinita, l'autore di una coda pubblica o privata abbia il pieno controllo e il gruppo di dominio Everyone dispone dell'autorizzazione per ottenere le proprietà della coda, ottenere le autorizzazioni e scrivere nella coda.By default, the creator of a public or private queue has full control, and the domain group Everyone has permission to get queue properties, get permissions, and write to the queue. Quando si chiama SetPermissions, le informazioni utente e le autorizzazioni vengono aggiunte alla fine dell'elenco esistente.When you call SetPermissions, the user and permissions information is appended to the bottom of the existing list.

Il sistema esamina ciascuna AccessControlEntry in sequenza fino a quando non si verifica uno degli eventi seguenti:The system examines each AccessControlEntry in sequence until one of the following events occurs:

  • Un accesso negato AccessControlEntry nega in modo esplicito uno qualsiasi dei diritti di accesso richiesto a una delle fiduciari elencati nel token di accesso del thread.An access-denied AccessControlEntry explicitly denies any of the requested access rights to one of the trustees listed in the thread's access token.

  • Uno o più Autorizzazione dell'accesso AccessControlEntry elementi per tutti i diritti di accesso richiesto di concessione fiduciari elencati nel token di accesso del thread in modo esplicito.One or more access-allowed AccessControlEntry items for trustees listed in the thread's access token explicitly grant all the requested access rights.

  • Tutti i AccessControlEntry articoli sono stati verificati e vi è ancora presente almeno un diritto di accesso che non è stato esplicitamente concesso, nel qual caso, l'accesso viene implicitamente negato.All AccessControlEntry items have been checked and there is still at least one requested access right that has not been explicitly allowed, in which case, access is implicitly denied.

I diritti a una coda, specificato nella rights parametro, può essere qualsiasi combinazione delle opzioni seguenti:The rights to a queue, specified in the rights parameter, can be any combination of the following:

  • Controllo completoFull Control

  • Eliminare messaggioDelete Message

  • Ricezione messaggioReceive Message

  • Visualizza il messaggioPeek Message

  • Ricevi messaggio JournalReceive Journal Message

  • Ottenere le proprietà della codaGet Queue Properties

  • Impostare le proprietà della codaSet Queue Properties

  • Ottenere le autorizzazioniGet Permissions

  • Impostare le autorizzazioniSet Permissions

  • Assumere la proprietà di codaTake Queue Ownership

  • WriteMessageWrite Message

Il MessageQueueAccessRights enumerazione rappresenta un set di flag di bit che è possibile combinare l'uso dell'operatore OR bit per bit o per compilare il rights parametro.The MessageQueueAccessRights enumeration represents a set of bit flags that you can combine using the bitwise operator OR to build the rights parameter.

Con questo overload, è possibile concedere solo autorizzazioni. non è possibile revocare o negare loro.With this overload, you can only grant permissions; you cannot revoke or deny them. È necessario usare un overload diverso per concedere in modo esplicito qualsiasi AccessControlEntryType diverso da Allow.You must use a different overload to explicitly grant any AccessControlEntryType other than Allow.

Nella tabella seguente indica se questo metodo è disponibile in varie modalità gruppo di lavoro.The following table shows whether this method is available in various Workgroup modes.

Modalità gruppo di lavoroWorkgroup mode DisponibileAvailable
Computer localeLocal computer Yes
Computer locale e il nome di formato directLocal computer and direct format name Yes
Computer remotoRemote computer NoNo
Computer remoto e il nome di formato directRemote computer and direct format name NoNo
Vedi anche

SetPermissions(String, MessageQueueAccessRights, AccessControlEntryType) SetPermissions(String, MessageQueueAccessRights, AccessControlEntryType) SetPermissions(String, MessageQueueAccessRights, AccessControlEntryType) SetPermissions(String, MessageQueueAccessRights, AccessControlEntryType)

Concede a un computer, a un utente o a un gruppo di utenti i diritti di accesso specificati con il tipo di controllo di accesso specificato (concessione, rifiuto, revoca o impostazione).Gives a computer, group, or user the specified access rights, with the specified access control type (allow, deny, revoke, or set).

public:
 void SetPermissions(System::String ^ user, System::Messaging::MessageQueueAccessRights rights, System::Messaging::AccessControlEntryType entryType);
public void SetPermissions (string user, System.Messaging.MessageQueueAccessRights rights, System.Messaging.AccessControlEntryType entryType);
member this.SetPermissions : string * System.Messaging.MessageQueueAccessRights * System.Messaging.AccessControlEntryType -> unit
Public Sub SetPermissions (user As String, rights As MessageQueueAccessRights, entryType As AccessControlEntryType)

Parametri

user
String String String String

Singolo utente, gruppo o computer che ottiene ulteriori diritti per la coda.The individual, group, or computer that gets additional rights to the queue.

rights
MessageQueueAccessRights MessageQueueAccessRights MessageQueueAccessRights MessageQueueAccessRights

Oggetto MessageQueueAccessRights che indica una serie di diritti per la coda assegnati da Accodamento messaggi al parametro user passato.A MessageQueueAccessRights that indicates the set of rights to the queue that Message Queuing assigns to the user passed in.

entryType
AccessControlEntryType AccessControlEntryType AccessControlEntryType AccessControlEntryType

Oggetto AccessControlEntryType che specifica se concedere, negare o revocare le autorizzazioni specificate dal parametro rights.A AccessControlEntryType that specifies whether to grant, deny, or revoke the permissions specified by the rights parameter.

Eccezioni

Si è verificato un errore durante l'accesso a un metodo di Accodamento messaggi.An error occurred when accessing a Message Queuing method.

Esempi

L'esempio di codice seguente illustra l'uso di SetPermissions(String, MessageQueueAccessRights, AccessControlEntryType).The following code example demonstrates the use of SetPermissions(String, MessageQueueAccessRights, AccessControlEntryType).


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

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

queue->Close();


// 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,
    AccessControlEntryType.Allow);

Commenti

Utilizzare questo overload per concedere, negare o revocare i diritti specificati per un singolo utente.Use this overload to grant, deny, or revoke specified rights for an individual user. L'utente può essere qualsiasi fiduciario valido, che include i singoli utenti, gruppi di utenti o un computer.The user can be any valid trustee, which includes individual users, groups of users, or a computer. Se l'utente è una persona, usare il formato DOMAIN \ user per il user parametro.If the user is an individual, use the format DOMAIN\user for the user parameter. È possibile specificare "." per il user parametro per indicare il computer locale.You can specify "." for the user parameter to indicate the local computer.

Le autorizzazioni assegnate tramite SetPermissions aggiungere le autorizzazioni per l'elenco esistente.The permissions you assign through SetPermissions add rights to the existing list. Per impostazione predefinita, l'autore di una coda pubblica o privata abbia il pieno controllo e il gruppo di dominio Everyone dispone dell'autorizzazione per ottenere le proprietà della coda, ottenere le autorizzazioni e scrivere nella coda.By default, the creator of a public or private queue has full control, and the domain group Everyone has permission to get queue properties, get permissions, and write to the queue. Quando si chiama SetPermissions, le informazioni utente e le autorizzazioni vengono aggiunte alla fine dell'elenco esistente.When you call SetPermissions, the user and permissions information is appended to the bottom of the existing list.

Il sistema esamina ciascuna AccessControlEntry in sequenza fino a quando non si verifica uno degli eventi seguenti:The system examines each AccessControlEntry in sequence until one of the following events occurs:

  • Un accesso negato AccessControlEntry nega in modo esplicito uno qualsiasi dei diritti di accesso richiesto a una delle fiduciari elencati nel token di accesso del thread.An access-denied AccessControlEntry explicitly denies any of the requested access rights to one of the trustees listed in the thread's access token.

  • Uno o più Autorizzazione dell'accesso AccessControlEntry elementi per tutti i diritti di accesso richiesto di concessione fiduciari elencati nel token di accesso del thread in modo esplicito.One or more access-allowed AccessControlEntry items for trustees listed in the thread's access token explicitly grant all the requested access rights.

  • Tutti i AccessControlEntry articoli sono stati verificati e vi è ancora presente almeno un diritto di accesso che non è stato esplicitamente concesso, nel qual caso, l'accesso viene implicitamente negato.All AccessControlEntry items have been checked and there is still at least one requested access right that has not been explicitly allowed, in which case, access is implicitly denied.

I diritti a una coda, specificato nella rights parametro, può essere qualsiasi combinazione delle opzioni seguenti:The rights to a queue, specified in the rights parameter, can be any combination of the following:

  • Controllo completoFull Control

  • Eliminare messaggioDelete Message

  • Ricezione messaggioReceive Message

  • Visualizza il messaggioPeek Message

  • Ricevi messaggio JournalReceive Journal Message

  • Ottenere le proprietà della codaGet Queue Properties

  • Impostare le proprietà della codaSet Queue Properties

  • Ottenere le autorizzazioniGet Permissions

  • Impostare le autorizzazioniSet Permissions

  • Assumere la proprietà di codaTake Queue Ownership

  • WriteMessageWrite Message

Il MessageQueueAccessRights enumerazione rappresenta un set di flag di bit che è possibile combinare l'uso dell'operatore OR bit per bit o per compilare il rights parametro.The MessageQueueAccessRights enumeration represents a set of bit flags that you can combine using the bitwise operator OR to build the rights parameter.

Nella tabella seguente indica se questo metodo è disponibile in varie modalità gruppo di lavoro.The following table shows whether this method is available in various Workgroup modes.

Modalità gruppo di lavoroWorkgroup mode DisponibileAvailable
Computer localeLocal computer Yes
Computer locale e il nome di formato directLocal computer and direct format name Yes
Computer remotoRemote computer NoNo
Computer remoto e il nome di formato directRemote computer and direct format name NoNo
Vedi anche

Si applica a