MessageQueueAccessControlEntry Class

Definition

Especifica os direitos de acesso para um objeto de confiança (usuário, grupo ou computador) para executar tarefas de Enfileiramento de Mensagens.Specifies access rights for a trustee (user, group, or computer) to perform Message Queuing tasks.

public ref class MessageQueueAccessControlEntry : System::Messaging::AccessControlEntry
public class MessageQueueAccessControlEntry : System.Messaging.AccessControlEntry
type MessageQueueAccessControlEntry = class
    inherit AccessControlEntry
Public Class MessageQueueAccessControlEntry
Inherits AccessControlEntry
Inheritance
MessageQueueAccessControlEntry

Remarks

Use a classe MessageQueueAccessControlEntry para especificar os direitos a serem aplicados a um confiável.Use the MessageQueueAccessControlEntry class to specify rights to apply to a trustee. Esses direitos incluem inspecionar, receber ou enviar mensagens; Exibindo ou modificando Propriedades ou permissões de fila; e excluindo filas.These rights include peeking, receiving, or sending messages; viewing or modifying queue properties or permissions; and deleting queues. O método SetPermissions da classe MessageQueue fornece sobrecargas para passar uma instância dessa classe diretamente para o método ou adicioná-la a uma instância de AccessControlList para que você possa adicionar direitos para mais de um confiável de cada vez.The MessageQueue class's SetPermissions method provides overloads for passing an instance of this class directly into the method, or adding it to an instance of AccessControlList so that you can add rights for more than one trustee at a time. O novo direito de acesso é acrescentado ao final da DACL (lista de controle de acesso discricionário) da fila, que identifica os usuários e grupos que podem acessar a fila.The new access right is appended to the end of the queue's discretionary access control list (DACL), which identifies the users and groups that can access the queue.

Há algumas exceções a essa generalização sobre onde o novo direito é adicionado e seus efeitos.There are some exceptions to this generalization about where the new right is added and its effects. Para obter mais informações, consulte System.Messaging.For more information, see System.Messaging.

Uma sobrecarga do Construtor MessageQueueAccessControlEntry permite especificar um membro AccessControlEntryType para indicar se os direitos devem ser permitidos ou negados ao confiável.An overload of the MessageQueueAccessControlEntry constructor allows you specify a AccessControlEntryType member to indicate whether to allow or deny rights to the trustee. A ordem na qual os direitos são permitidos ou negados na DACL do recurso afeta se o Trustee tem os direitos especificados.The order in which rights are allowed or denied in the resource's DACL affects whether the trustee has the specified rights. Por exemplo, se os direitos já tiverem sido concedidos ao Trustee e posteriormente você adicionar uma entrada que os negue, o sistema localizará os direitos concedidos primeiro e, portanto, o usuário receberá os direitos que você pode ter pretendido para serem negados.For example, if rights have already been granted to the trustee and you later add an entry that denies them, the system finds the granted rights first, so the user is granted rights you might have intended they be denied. Você pode usar dois tipos de entrada para substituir esse comportamento: Set e Revoke.You can use two entry types to override this behavior: Set and Revoke. Para obter mais informações sobre como controlar a maneira como os direitos de acesso são determinados, consulte o tópico AccessControlEntryType Enumeration.For more information about controlling the way in which access rights are determined, see the AccessControlEntryType enumeration topic.

A classe MessageQueueAccessControlEntry é associada à segurança com base nas listas de controle de acesso (ACLs), que você pode usar para conceder aos usuários acesso ao próprio sistema de enfileiramento de mensagens.The MessageQueueAccessControlEntry class is associated with security based on access control lists (ACLs), which you can use to give users access to the Message Queuing system itself. Isso é diferente da segurança de acesso ao código, que é implementada por meio do MessageQueuePermission e das classes relacionadas.This is different from code access security, which is implemented through the MessageQueuePermission and related classes. A segurança de acesso ao código do enfileiramento de mensagens define as operações específicas da fila ou o acesso à fila que um aplicativo pode exigir, que está sujeito ao controle de segurança; Ele não representa um direito para o aplicativo executar essas operações ou receber acesso por si só.Message Queuing code access security defines queue-specific operations or queue access that an application might require which is subject to security control; it does not represent a right for the application to perform these operations or receive access in and of itself. Consulte o tópico segurança de acesso ao código para obter mais informações sobre a segurança de acesso do código.See the topic Code Access Security for more information about code access security.

Para definir permissões de fila de mensagens para um confiável, crie uma nova instância da classe Trustee e passe-a em uma sobrecarga do Construtor MessageQueueAccessControlEntry.To set message queue permissions for a trustee, create a new instance of the Trustee class and pass it into an overload of the MessageQueueAccessControlEntry constructor. Especifique os direitos de acesso à fila de mensagens passando uma instância do MessageQueueAccessRights para o construtor ou definindo a propriedade MessageQueueAccessRights em uma instância existente do MessageQueueAccessControlEntry.Specify the message queue access rights either by passing an instance of MessageQueueAccessRights into the constructor or by setting the MessageQueueAccessRights property on an existing MessageQueueAccessControlEntry instance.

Em seguida, você pode passar a instância de MessageQueueAccessControlEntry diretamente para o método MessageQueue.SetPermissions ou adicionar a entrada a uma instância de AccessControlList de forma alternativa antes de chamar SetPermissions.You can then pass the MessageQueueAccessControlEntry instance directly to the MessageQueue.SetPermissions method, or alternately add the entry to an instance of AccessControlList before calling SetPermissions.

Constructors

MessageQueueAccessControlEntry(Trustee, MessageQueueAccessRights)

Inicializa uma nova instância da classe MessageQueueAccessControlEntry concedendo direitos de acesso de Enfileiramento de Mensagens especificados para o objeto de confiança especificado.Initializes a new instance of the MessageQueueAccessControlEntry class, granting the specified Message Queuing access rights to the specified trustee.

MessageQueueAccessControlEntry(Trustee, MessageQueueAccessRights, AccessControlEntryType)

Inicializa uma nova instância da classe MessageQueueAccessControlEntry com o objeto de confiança e os direitos de acesso de Enfileiramento de Mensagens especificados.Initializes a new instance of the MessageQueueAccessControlEntry class, with the specified trustee and Message Queuing access rights. O tipo de acesso (como Allow ou Deny) é definido pelo tipo de entrada que você transmite.The type of access (such as Allow or Deny) is defined by the entry type you pass in.

Properties

CustomAccessRights

Obtém ou define direitos de acesso personalizados.Gets or sets custom access rights.

(Inherited from AccessControlEntry)
EntryType

Obtém ou define um valor que indica como os direitos de acesso se aplicam ao confiável.Gets or sets a value that indicates how the access rights apply to the trustee.

(Inherited from AccessControlEntry)
GenericAccessRights

Obtém ou define um conjunto de direitos de acesso comuns que são mapeados para direitos de acesso padrão e específico de objeto para leitura, gravação e execução.Gets or sets a set of common access rights that map to both standard and object-specific access rights for reading, writing, and executing.

(Inherited from AccessControlEntry)
MessageQueueAccessRights

Obtém ou define o conjunto de direitos específicos do Enfileiramento de Mensagens a aplicar ao objeto de confiança.Gets or sets the set of Message Queuing-specific rights to apply to the trustee.

StandardAccessRights

Obtém ou define um conjunto de direitos de acesso padrão que corresponde a operações comuns à maioria dos tipos de objetos protegíveis.Gets or sets a set of standard access rights that correspond to operations common to most types of securable objects.

(Inherited from AccessControlEntry)
Trustee

Obtém ou define usuário, grupo, domínio ou alias ao qual você está atribuindo direitos de acesso.Gets or sets the user, group, domain, or alias to which you are assigning access rights.

(Inherited from AccessControlEntry)

Methods

Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetHashCode()

Serve como a função de hash padrão.Serves as the default hash function.

(Inherited from Object)
GetType()

Obtém o Type da instância atual.Gets the Type of the current instance.

(Inherited from Object)
MemberwiseClone()

Cria uma cópia superficial do Object atual.Creates a shallow copy of the current Object.

(Inherited from Object)
ToString()

Retorna uma cadeia de caracteres que representa o objeto atual.Returns a string that represents the current object.

(Inherited from Object)

Applies to

See also