MessageQueue.SetPermissions Méthode

Référence

Définition

Espace de noms:: System.Messaging

Assembly:: System.Messaging.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Ajoute des autorisations au jeu en cours. Ceci permet de contrôler les utilisateurs ayant des droits d'accès aux propriétés de la file d'attente ainsi qu'aux messages de la file.

Surcharges

SetPermissions(AccessControlList)	Assigne les droits d'accès à la file d'attente en fonction du contenu d'une liste de contrôle d'accès.
SetPermissions(MessageQueueAccessControlEntry)	Assigne des droits d'accès à la file d'attente en fonction du contenu d'une entrée du contrôle d'accès.
SetPermissions(String, MessageQueueAccessRights)	Donne les droits d'accès spécifiés à un ordinateur, un groupe ou un utilisateur.
SetPermissions(String, MessageQueueAccessRights, AccessControlEntryType)	Accorde à un ordinateur, à un groupe ou à un utilisateur les droits d'accès spécifiés, avec le type de contrôle d'accès spécifié (allow, deny, revoke ou set).

SetPermissions(AccessControlList)

Assigne les droits d'accès à la file d'attente en fonction du contenu d'une liste de contrôle d'accès.

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

dacl: AccessControlList

AccessControlList qui contient une ou plusieurs entrées du contrôle d'accès spécifiant les tiers de confiance et les autorisations à accorder.

Exceptions

MessageQueueException

Une erreur s'est produite lors de l'accès à une méthode Message Queuing.

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.

Mode groupe de travail	Disponible
Ordinateur local	Oui
Ordinateur local et nom de format direct	Oui
Ordinateur distant	Non
Ordinateur distant et nom de format direct	Non

Voir aussi

S’applique à

SetPermissions(MessageQueueAccessControlEntry)

Assigne des droits d'accès à la file d'attente en fonction du contenu d'une entrée du contrôle d'accès.

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

ace: MessageQueueAccessControlEntry

MessageQueueAccessControlEntry qui spécifie un utilisateur, un type d'accès ou un type d'autorisation.

Exceptions

MessageQueueException

Une erreur s'est produite lors de l'accès à une méthode Message Queuing.

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 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.

Mode groupe de travail	Disponible
Ordinateur local	Oui
Ordinateur local et nom de format direct	Oui
Ordinateur distant	Non
Ordinateur distant et nom de format direct	Non

Voir aussi

S’applique à

SetPermissions(String, MessageQueueAccessRights)

Donne les droits d'accès spécifiés à un ordinateur, un groupe ou un utilisateur.

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

user: String

L'individu, le groupe ou l'ordinateur obtenant des droits d'accès supplémentaires à la file d'attente.

rights: MessageQueueAccessRights

MessageQueueAccessRights indiquant l'ensemble des droits d'accès à la file d'attente assignés par Message Queuing au user passé.

Exceptions

ArgumentException

user a la valeur null.

MessageQueueException

Une erreur s'est produite lors de l'accès à une méthode Message Queuing.

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.

Mode groupe de travail	Disponible
Ordinateur local	Oui
Ordinateur local et nom de format direct	Oui
Ordinateur distant	Non
Ordinateur distant et nom de format direct	Non

Voir aussi

S’applique à

SetPermissions(String, MessageQueueAccessRights, AccessControlEntryType)

Accorde à un ordinateur, à un groupe ou à un utilisateur les droits d'accès spécifiés, avec le type de contrôle d'accès spécifié (allow, deny, revoke ou 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)

Paramètres

user: String

L'individu, le groupe ou l'ordinateur obtenant des droits d'accès supplémentaires à la file d'attente.

rights: MessageQueueAccessRights

MessageQueueAccessRights indiquant l'ensemble des droits d'accès à la file d'attente assignés par Message Queuing au user passé.

entryType: AccessControlEntryType

AccessControlEntryType qui spécifie si les autorisations spécifiées par le paramètre rights doivent être accordées, refusées ou révoquées.

Exceptions

MessageQueueException

Une erreur s'est produite lors de l'accès à une méthode Message Queuing.

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.

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

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

Mode groupe de travail	Disponible
Ordinateur local	Oui
Ordinateur local et nom de format direct	Oui
Ordinateur distant	Non
Ordinateur distant et nom de format direct	Non

Voir aussi

S’applique à

Partager via

MessageQueue.SetPermissions Méthode

Définition

Surcharges

SetPermissions(AccessControlList)

Paramètres

Exceptions

Exemples

Remarques

Voir aussi

S’applique à

SetPermissions(MessageQueueAccessControlEntry)

Paramètres

Exceptions

Exemples

Remarques

Voir aussi

S’applique à

SetPermissions(String, MessageQueueAccessRights)

Paramètres

Exceptions

Exemples

Remarques

Voir aussi

S’applique à

SetPermissions(String, MessageQueueAccessRights, AccessControlEntryType)

Paramètres

Exceptions

Exemples

Remarques

Voir aussi

S’applique à

Ressources supplémentaires