MessageQueue.SetPermissions Méthode

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)

Paramètres

Exceptions

Exemples

L'exemple de code suivant montre l'utilisation de 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);

Remarques

Utilisez cette surcharge pour accorder, refuser ou révoquer des droits à l’aide d’une collection d’entrées de contrôle d’accès pour spécifier des informations sur le fiduciaire et les autorisations. Cela est utilisé, par exemple, pour accorder des autorisations à plusieurs utilisateurs en même temps.

Le fiduciaire que vous spécifiez lorsque vous construisez le ace paramètre peut être un utilisateur individuel, un groupe d’utilisateurs ou un ordinateur. Si le fiduciaire est un individu, utilisez le format DOMAIN\user. Vous pouvez spécifier « . » pour que le fiduciaire indique l’ordinateur local.

Les autorisations que vous attribuez via SetPermissions ajoutent des droits à la liste existante. Par défaut, le créateur d’une file d’attente publique ou privée a un contrôle total, et le groupe de domaines Tout le monde a l’autorisation d’obtenir les propriétés de la file d’attente, d’obtenir des autorisations et d’écrire dans la file d’attente. Lorsque vous appelez SetPermissions, les informations sur l’utilisateur et les autorisations sont ajoutées au bas de la liste existante.

Le système examine chacune AccessControlEntry d’elles dans l’ordre jusqu’à ce que l’un des événements suivants se produise :

• Un accès refusé AccessControlEntry refuse explicitement l’un des droits d’accès demandés à l’un des administrateurs répertoriés dans le jeton d’accès du thread.

• Un ou plusieurs éléments autorisés AccessControlEntry par accès pour les fiduciaires répertoriés dans le jeton d’accès du thread accordent explicitement tous les droits d’accès demandés.

• Tous les AccessControlEntry éléments ont été vérifiés et il existe toujours au moins un droit d’accès demandé qui n’a pas été explicitement autorisé, auquel cas l’accès est implicitement refusé.

Lorsque vous construisez le dacl paramètre, vous ajoutez AccessControlEntry des instances à votre AccessControlList collection. Lorsque vous construisez chaque entrée de contrôle d’accès, vous pouvez spécifier des droits d’accès génériques ou standard. Les droits sur une file d’attente peuvent être n’importe quelle combinaison des éléments suivants :

• Supprimer

• Consulter les données relatives à la sécurité

• Sécurité de l’écriture

• Synchroniser

• Modifier le propriétaire

• Lire

• Write

• Execute

• Obligatoire

• Tous

• Aucune

Ces droits sont un ensemble d’indicateurs de bits que vous pouvez combiner à l’aide de l’opérateur OR au niveau du bit.

• Contrôle total

• Supprimer un message

• Recevoir un message

• Lire furtivement un message

• Recevoir un message Journal

• Obtenir les propriétés de la file d’attente

• Définir les propriétés de la file d’attente

• Obtenir des autorisations

• Définir les autorisations

• Prendre la propriété de la file d’attente

• Écrire un message

Le tableau suivant indique si cette méthode est disponible dans différents modes de groupe de travail.

Voir aussi

• ResetPermissions()
• Trustee
• AccessControlList

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)

Paramètres

Exceptions

Exemples

L'exemple de code suivant montre l'utilisation de 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);

Remarques

Utilisez cette surcharge pour accorder, refuser ou révoquer des droits à l’aide d’une entrée de contrôle d’accès pour spécifier les informations sur les droits et les administrateurs.

Le fiduciaire que vous spécifiez lorsque vous construisez le ace paramètre peut être un utilisateur individuel, un groupe d’utilisateurs ou un ordinateur. Si le fiduciaire est un individu, utilisez le format DOMAIN\user. Vous pouvez spécifier « . » pour que le fiduciaire indique l’ordinateur local.

Les autorisations que vous attribuez via SetPermissions ajoutent des droits à la liste existante. Par défaut, le créateur d’une file d’attente publique ou privée a un contrôle total, et le groupe de domaines Tout le monde a l’autorisation d’obtenir les propriétés de la file d’attente, d’obtenir des autorisations et d’écrire dans la file d’attente. Lorsque vous appelez SetPermissions, les informations sur l’utilisateur et les autorisations sont ajoutées au bas de la liste existante.

Le système examine chacune AccessControlEntry d’elles dans l’ordre jusqu’à ce que l’un des événements suivants se produise :

• Un accès refusé AccessControlEntry refuse explicitement l’un des droits d’accès demandés à l’un des administrateurs répertoriés dans le jeton d’accès du thread.

• Un ou plusieurs éléments autorisés AccessControlEntry par accès pour les fiduciaires répertoriés dans le jeton d’accès du thread accordent explicitement tous les droits d’accès demandés.

• Tous les AccessControlEntry éléments ont été vérifiés et il existe toujours au moins un droit d’accès demandé qui n’a pas été explicitement autorisé, auquel cas l’accès est implicitement refusé.

Les droits sur une file d’attente, que vous spécifiez dans le rights paramètre lorsque vous construisez votre MessageQueueAccessControlEntry, peuvent être n’importe quelle combinaison des éléments suivants :

• Contrôle total

• Supprimer un message

• Recevoir un message

• Lire furtivement un message

• Recevoir un message Journal

• Obtenir les propriétés de la file d’attente

• Définir les propriétés de la file d’attente

• Obtenir des autorisations

• Définir les autorisations

• Prendre la propriété de la file d’attente

• Écrire un message

Le rights paramètre que vous spécifiez dans le constructeur pour le ace paramètre est un indicateur de l’énumération MessageQueueAccessRights . Il représente un ensemble d’indicateurs de bits que vous pouvez combiner à l’aide de l’opérateur au niveau du bit OU lorsque vous générez le rights paramètre.

Le tableau suivant indique si cette méthode est disponible dans différents modes de groupe de travail.

Voir aussi

• ResetPermissions()
• Trustee
• MessageQueueAccessRights
• MessageQueueAccessControlEntry

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)

Paramètres

Exceptions

Exemples

L'exemple de code suivant montre l'utilisation de 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);

Remarques

Utilisez cette surcharge pour accorder des droits spécifiés à un utilisateur individuel. L’utilisateur peut être n’importe quel fiduciaire valide, ce qui inclut des utilisateurs individuels, des groupes d’utilisateurs ou un ordinateur. Si l’utilisateur est un individu, utilisez le format DOMAIN\user du user paramètre. Vous pouvez spécifier « ». pour que le user paramètre indique l’ordinateur local.

Les autorisations que vous attribuez par le biais SetPermissions d’ajouter des droits à la liste existante. Par défaut, le créateur d’une file d’attente publique ou privée a le contrôle total, et le groupe de domaines Tout le monde a l’autorisation d’obtenir les propriétés de la file d’attente, d’obtenir des autorisations et d’écrire dans la file d’attente. Lorsque vous appelez SetPermissions, les informations sur l’utilisateur et les autorisations sont ajoutées au bas de la liste existante.

Le système examine chacun AccessControlEntry dans l’ordre jusqu’à ce que l’un des événements suivants se produise :

• Un accès refusé AccessControlEntry refuse explicitement l’un des droits d’accès demandés à l’un des administrateurs répertoriés dans le jeton d’accès du thread.

• Un ou plusieurs éléments autorisés AccessControlEntry à accéder pour les fiduciaires répertoriés dans le jeton d’accès du thread accordent explicitement tous les droits d’accès demandés.

• Tous les AccessControlEntry éléments ont été vérifiés et au moins un droit d’accès demandé n’a pas été explicitement autorisé, auquel cas l’accès est implicitement refusé.

Les droits d’une file d’attente, spécifiés dans le rights paramètre, peuvent être n’importe quelle combinaison des éléments suivants :

• Contrôle total

• Supprimer un message

• Recevoir un message

• Lire furtivement un message

• Recevoir Journal message

• Obtenir les propriétés de la file d’attente

• Définir les propriétés de la file d’attente

• Obtenir des autorisations

• Définir les autorisations

• Prendre la propriété de la file d’attente

• Écrire un message

L’énumération MessageQueueAccessRights représente un ensemble d’indicateurs de bits que vous pouvez combiner à l’aide de l’opérateur au niveau du bit OR pour générer le rights paramètre.

Avec cette surcharge, vous pouvez uniquement accorder des autorisations ; vous ne pouvez pas les révoquer ou les refuser. Vous devez utiliser une surcharge différente pour accorder explicitement toute AccessControlEntryType autre que Allow.

Le tableau suivant indique si cette méthode est disponible dans différents modes de groupe de travail.

Voir aussi

• ResetPermissions()
• Trustee
• MessageQueueAccessRights

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)

Paramètres

Exceptions

Exemples

L'exemple de code suivant montre l'utilisation de 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);

Remarques

Utilisez cette surcharge pour accorder, refuser ou révoquer des droits spécifiés pour un utilisateur individuel. L’utilisateur peut être n’importe quel fiduciaire valide, ce qui inclut des utilisateurs individuels, des groupes d’utilisateurs ou un ordinateur. Si l’utilisateur est un individu, utilisez le format DOMAIN\user du user paramètre. Vous pouvez spécifier « ». pour que le user paramètre indique l’ordinateur local.

Les autorisations que vous attribuez par le biais SetPermissions d’ajouter des droits à la liste existante. Par défaut, le créateur d’une file d’attente publique ou privée a le contrôle total, et le groupe de domaines Tout le monde a l’autorisation d’obtenir les propriétés de la file d’attente, d’obtenir des autorisations et d’écrire dans la file d’attente. Lorsque vous appelez SetPermissions, les informations sur l’utilisateur et les autorisations sont ajoutées au bas de la liste existante.

Le système examine chacun AccessControlEntry dans l’ordre jusqu’à ce que l’un des événements suivants se produise :

• Un accès refusé AccessControlEntry refuse explicitement l’un des droits d’accès demandés à l’un des administrateurs répertoriés dans le jeton d’accès du thread.

• Un ou plusieurs éléments autorisés AccessControlEntry à accéder pour les fiduciaires répertoriés dans le jeton d’accès du thread accordent explicitement tous les droits d’accès demandés.

• Tous les AccessControlEntry éléments ont été vérifiés et au moins un droit d’accès demandé n’a pas été explicitement autorisé, auquel cas l’accès est implicitement refusé.

Les droits d’une file d’attente, spécifiés dans le rights paramètre, peuvent être n’importe quelle combinaison des éléments suivants :

• Contrôle total

• Supprimer un message

• Recevoir un message

• Lire furtivement un message

• Recevoir Journal message

• Obtenir les propriétés de la file d’attente

• Définir les propriétés de la file d’attente

• Obtenir des autorisations

• Définir les autorisations

• Prendre la propriété de la file d’attente

• Écrire un message

L’énumération MessageQueueAccessRights représente un ensemble d’indicateurs de bits que vous pouvez combiner à l’aide de l’opérateur au niveau du bit OR pour générer le rights paramètre.

Le tableau suivant indique si cette méthode est disponible dans différents modes de groupe de travail.

Voir aussi

• ResetPermissions()
• Trustee
• MessageQueueAccessRights
• AccessControlEntry