MessageQueue.SetPermissions Método

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)

Parâmetros

Exceções

Exemplos

O exemplo de código a seguir demonstra o uso 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);

Observações

Use esta sobrecarga para conceder, negar ou revogar direitos, utilizando um conjunto de entradas de controlo de acesso para especificar informações de trustee e permissões. Isto é usado, por exemplo, para conceder permissões a vários utilizadores ao mesmo tempo.

O trustee que especifica quando constrói o ace parâmetro pode ser um utilizador individual, um grupo de utilizadores ou um computador. Se o administrador for um indivíduo, utilize o formato DOMAIN\user. Pode especificar "." para o administrador indicar o computador local.

As permissões que atribuis SetPermissions adicionam direitos à lista existente. Por defeito, o criador de uma fila pública ou privada tem controlo total, e o grupo de domínios Todos têm permissão para obter propriedades da fila, obter permissões e escrever na fila. Quando chama SetPermissions, a informação do utilizador e das permissões é adicionada ao final da lista existente.

O sistema examina cada um AccessControlEntry em sequência até que ocorra um dos seguintes eventos:

• Um acesso negado AccessControlEntry nega explicitamente qualquer um dos direitos de acesso solicitados a um dos trustees listados no token de acesso do tópico.

• Um ou mais itens permitidos AccessControlEntry de acesso para trustees listados no token de acesso do tópico concedem explicitamente todos os direitos de acesso solicitados.

• Todos AccessControlEntry os itens foram verificados e ainda existe pelo menos um direito de acesso solicitado que não foi explicitamente permitido, caso em que o acesso é implicitamente negado.

Quando constróis o dacl parâmetro, adicionas AccessControlEntry instâncias à tua AccessControlList coleção. Quando constrói cada entrada de controlo de acesso, pode especificar direitos de acesso genéricos ou padrão. Os direitos de uma fila podem ser qualquer combinação dos seguintes:

• Eliminar

• Leia Segurança

• Segurança de Escrita

• Synchronize

• Modificar Proprietário

• Leitura

• Escreve

• Execute

• Obrigatório

• Todos

• None

Estes direitos são um conjunto de flags de bits que pode combinar usando o operador bit a bit OR.

• Controlo Total

• Excluir mensagem

• Receber Mensagem

• Mensagem Espreitar

• Receber Mensagem do Diário

• Obter Propriedades da Fila

• Definir Propriedades da Fila

• Obtenha permissões

• Definir permissões

• Vejamos a Posse da Fila

• Escrever Mensagem

A tabela seguinte mostra se este método está disponível em vários modos de Grupo de Trabalho.

Ver também

• 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)

Parâmetros

Exceções

Exemplos

O exemplo de código a seguir demonstra o uso 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);

Observações

Utilize esta sobrecarga para conceder, negar ou revogar direitos, utilizando uma entrada de controlo de acesso para especificar informações de trustee e direitos.

O trustee que especifica quando constrói o ace parâmetro pode ser um utilizador individual, um grupo de utilizadores ou um computador. Se o administrador for um indivíduo, utilize o formato DOMAIN\user. Pode especificar "." para o administrador indicar o computador local.

As permissões que atribuis SetPermissions adicionam direitos à lista existente. Por defeito, o criador de uma fila pública ou privada tem controlo total, e o grupo de domínios Todos têm permissão para obter propriedades da fila, obter permissões e escrever na fila. Quando chama SetPermissions, a informação do utilizador e das permissões é adicionada ao final da lista existente.

O sistema examina cada um AccessControlEntry em sequência até que ocorra um dos seguintes eventos:

• Um acesso negado AccessControlEntry nega explicitamente qualquer um dos direitos de acesso solicitados a um dos trustees listados no token de acesso do tópico.

• Um ou mais itens permitidos AccessControlEntry de acesso para trustees listados no token de acesso do tópico concedem explicitamente todos os direitos de acesso solicitados.

• Todos AccessControlEntry os itens foram verificados e ainda existe pelo menos um direito de acesso solicitado que não foi explicitamente permitido, caso em que o acesso é implicitamente negado.

Os direitos de uma fila, que especifica no rights parâmetro ao construir o seu MessageQueueAccessControlEntry, podem ser qualquer combinação do seguinte:

• Controlo Total

• Excluir mensagem

• Receber Mensagem

• Mensagem Espreitar

• Receber Mensagem do Diário

• Obter Propriedades da Fila

• Definir Propriedades da Fila

• Obtenha permissões

• Definir permissões

• Vejamos a Posse da Fila

• Escrever Mensagem

O rights parâmetro que especifica no construtor para o ace parâmetro é um flag da MessageQueueAccessRights enumeração. Representa um conjunto de flags de bits que podes combinar usando o operador bit a bit OU quando constróis o rights parâmetro.

A tabela seguinte mostra se este método está disponível em vários modos de Grupo de Trabalho.

Ver também

• 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)

Parâmetros

Exceções

Exemplos

O exemplo de código a seguir demonstra o uso 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);

Observações

Usar esta sobrecarga para conceder direitos específicos a um utilizador individual. O utilizador pode ser qualquer trustee válido, incluindo utilizadores individuais, grupos de utilizadores ou um computador. Se o utilizador for um indivíduo, use o formato DOMAIN\user para o user parâmetro. Pode especificar "." como user parâmetro para indicar o computador local.

As permissões que atribuis SetPermissions adicionam direitos à lista existente. Por defeito, o criador de uma fila pública ou privada tem controlo total, e o grupo de domínios Todos têm permissão para obter propriedades da fila, obter permissões e escrever na fila. Quando chama SetPermissions, a informação do utilizador e das permissões é adicionada ao final da lista existente.

O sistema examina cada um AccessControlEntry em sequência até que ocorra um dos seguintes eventos:

• Um acesso negado AccessControlEntry nega explicitamente qualquer um dos direitos de acesso solicitados a um dos trustees listados no token de acesso do tópico.

• Um ou mais itens permitidos AccessControlEntry de acesso para trustees listados no token de acesso do tópico concedem explicitamente todos os direitos de acesso solicitados.

• Todos AccessControlEntry os itens foram verificados e ainda existe pelo menos um direito de acesso solicitado que não foi explicitamente permitido, caso em que o acesso é implicitamente negado.

Os direitos de uma fila, especificados no rights parâmetro, podem ser qualquer combinação dos seguintes:

• Controlo Total

• Excluir mensagem

• Receber Mensagem

• Mensagem Espreitar

• Receber Mensagem do Diário

• Obter Propriedades da Fila

• Definir Propriedades da Fila

• Obtenha permissões

• Definir permissões

• Vejamos a Posse da Fila

• Escrever Mensagem

A MessageQueueAccessRights enumeração representa um conjunto de flags de bits que pode combinar usando o operador bit a bit OR para construir o rights parâmetro.

Com esta sobrecarga, só podes conceder permissões; Não pode revogar ou negar essa informação. Deves usar uma sobrecarga diferente para conceder explicitamente qualquer AccessControlEntryType outra que não Allowseja .

A tabela seguinte mostra se este método está disponível em vários modos de Grupo de Trabalho.

Ver também

• 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)

Parâmetros

Exceções

Exemplos

O exemplo de código a seguir demonstra o uso 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);

Observações

Use esta sobrecarga para conceder, negar ou revogar direitos especificados a um utilizador individual. O utilizador pode ser qualquer trustee válido, incluindo utilizadores individuais, grupos de utilizadores ou um computador. Se o utilizador for um indivíduo, use o formato DOMAIN\user para o user parâmetro. Pode especificar "." como user parâmetro para indicar o computador local.

As permissões que atribuis SetPermissions adicionam direitos à lista existente. Por defeito, o criador de uma fila pública ou privada tem controlo total, e o grupo de domínios Todos têm permissão para obter propriedades da fila, obter permissões e escrever na fila. Quando chama SetPermissions, a informação do utilizador e das permissões é adicionada ao final da lista existente.

O sistema examina cada um AccessControlEntry em sequência até que ocorra um dos seguintes eventos:

• Um acesso negado AccessControlEntry nega explicitamente qualquer um dos direitos de acesso solicitados a um dos trustees listados no token de acesso do tópico.

• Um ou mais itens permitidos AccessControlEntry de acesso para trustees listados no token de acesso do tópico concedem explicitamente todos os direitos de acesso solicitados.

• Todos AccessControlEntry os itens foram verificados e ainda existe pelo menos um direito de acesso solicitado que não foi explicitamente permitido, caso em que o acesso é implicitamente negado.

Os direitos de uma fila, especificados no rights parâmetro, podem ser qualquer combinação dos seguintes:

• Controlo Total

• Excluir mensagem

• Receber Mensagem

• Mensagem Espreitar

• Receber Mensagem do Diário

• Obter Propriedades da Fila

• Definir Propriedades da Fila

• Obtenha permissões

• Definir permissões

• Vejamos a Posse da Fila

• Escrever Mensagem

A MessageQueueAccessRights enumeração representa um conjunto de flags de bits que pode combinar usando o operador bit a bit OR para construir o rights parâmetro.

A tabela seguinte mostra se este método está disponível em vários modos de Grupo de Trabalho.

Ver também

• ResetPermissions()
• Trustee
• MessageQueueAccessRights
• AccessControlEntry