Partager via


MessageQueue.SetPermissions Méthode

Définition

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

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

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

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

user a la valeur null.

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

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.

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.

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 à