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

Excepciones

Ejemplos

En el ejemplo de código siguiente se muestra el 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);

Comentarios

Use esta sobrecarga para conceder, denegar o revocar derechos mediante una colección de entradas de control de acceso para especificar información de permisos y administrador de confianza. Esto se usa, por ejemplo, para conceder permisos a varios usuarios al mismo tiempo.

El administrador de confianza que especifique al construir el parámetro ace puede ser un usuario individual, un grupo de usuarios o un equipo. Si el administrador de confianza es individual, use el formato DOMAIN\user. Puede especificar "." para que el administrador de confianza indique el equipo local.

Los permisos que asigne a través de SetPermissions agregar derechos a la lista existente. De forma predeterminada, el creador de una cola pública o privada tiene control total y el grupo de dominio Todos tienen permiso para obtener propiedades de cola, obtener permisos y escribir en la cola. Al llamar a SetPermissions, la información de usuarios y permisos se anexa a la parte inferior de la lista existente.

El sistema examina cada AccessControlEntry en secuencia hasta que se produzca uno de los siguientes eventos:

• Un AccessControlEntry denegado de acceso deniega explícitamente cualquiera de los derechos de acceso solicitados a uno de los administradores enumerados en el token de acceso del subproceso.

• Uno o varios elementos de acceso permitidos AccessControlEntry para los administradores enumerados en el token de acceso del subproceso conceden explícitamente todos los derechos de acceso solicitados.

• Todos los AccessControlEntry elementos se han comprobado y todavía hay al menos un derecho de acceso solicitado que no se ha permitido explícitamente, en cuyo caso, el acceso se deniega implícitamente.

Al construir el parámetro dacl, se agregan instancias de AccessControlEntry a la colección de AccessControlList. Al construir cada entrada de control de acceso, puede especificar derechos de acceso genéricos o estándar. Los derechos de una cola pueden ser cualquier combinación de lo siguiente:

• Borrar

• Leer seguridad

• Seguridad de escritura

• Sincronizar

• Modificar propietario

• Leer

• Escribir

• Ejecutar

• Obligatorio

• Todo

• Ninguno

Estos derechos son un conjunto de marcas de bits que se pueden combinar mediante el operador OR bit a bit.

• Control total

• Eliminar mensaje

• Mensaje de recepción

• Ver mensaje

• Recibir mensaje del diario

• Obtener propiedades de cola

• Establecer propiedades de cola

• Obtener permisos

• Establecer permisos

• Tomar posesión de la cola

• Escribir mensaje

En la tabla siguiente se muestra si este método está disponible en varios modos de grupo de trabajo.

Consulte también

• 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

Excepciones

Ejemplos

En el ejemplo de código siguiente se muestra el 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);

Comentarios

Use esta sobrecarga para conceder, denegar o revocar derechos mediante una entrada de control de acceso para especificar información de derechos y administrador.

El administrador de confianza que especifique al construir el parámetro ace puede ser un usuario individual, un grupo de usuarios o un equipo. Si el administrador de confianza es individual, use el formato DOMAIN\user. Puede especificar "." para que el administrador de confianza indique el equipo local.

Los permisos que asigne a través de SetPermissions agregar derechos a la lista existente. De forma predeterminada, el creador de una cola pública o privada tiene control total y el grupo de dominio Todos tienen permiso para obtener propiedades de cola, obtener permisos y escribir en la cola. Al llamar a SetPermissions, la información de usuarios y permisos se anexa a la parte inferior de la lista existente.

El sistema examina cada AccessControlEntry en secuencia hasta que se produzca uno de los siguientes eventos:

• Un AccessControlEntry denegado de acceso deniega explícitamente cualquiera de los derechos de acceso solicitados a uno de los administradores enumerados en el token de acceso del subproceso.

• Uno o varios elementos de acceso permitidos AccessControlEntry para los administradores enumerados en el token de acceso del subproceso conceden explícitamente todos los derechos de acceso solicitados.

• Todos los AccessControlEntry elementos se han comprobado y todavía hay al menos un derecho de acceso solicitado que no se ha permitido explícitamente, en cuyo caso, el acceso se deniega implícitamente.

Los derechos de una cola, que especifique en el parámetro rights al construir el MessageQueueAccessControlEntry, pueden ser cualquier combinación de lo siguiente:

• Control total

• Eliminar mensaje

• Mensaje de recepción

• Ver mensaje

• Recibir mensaje del diario

• Obtener propiedades de cola

• Establecer propiedades de cola

• Obtener permisos

• Establecer permisos

• Tomar posesión de la cola

• Escribir mensaje

El parámetro rights que especifique en el constructor del parámetro ace es una marca de la enumeración MessageQueueAccessRights. Representa un conjunto de marcas de bits que se pueden combinar mediante el operador bit a bit OR al compilar el parámetro rights.

En la tabla siguiente se muestra si este método está disponible en varios modos de grupo de trabajo.

Consulte también

• 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

Excepciones

Ejemplos

En el ejemplo de código siguiente se muestra el 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);

Comentarios

Use esta sobrecarga para conceder derechos especificados a un usuario individual. El usuario puede ser cualquier administrador de confianza válido, que incluye usuarios individuales, grupos de usuarios o un equipo. Si el usuario es individual, use el formato DOMAIN\user para el parámetro user. Puede especificar "." para el parámetro user para indicar el equipo local.

Los permisos que asigne a través de SetPermissions agregar derechos a la lista existente. De forma predeterminada, el creador de una cola pública o privada tiene control total y el grupo de dominio Todos tienen permiso para obtener propiedades de cola, obtener permisos y escribir en la cola. Al llamar a SetPermissions, la información de usuarios y permisos se anexa a la parte inferior de la lista existente.

El sistema examina cada AccessControlEntry en secuencia hasta que se produzca uno de los siguientes eventos:

• Un AccessControlEntry denegado de acceso deniega explícitamente cualquiera de los derechos de acceso solicitados a uno de los administradores enumerados en el token de acceso del subproceso.

• Uno o varios elementos de acceso permitidos AccessControlEntry para los administradores enumerados en el token de acceso del subproceso conceden explícitamente todos los derechos de acceso solicitados.

• Todos los AccessControlEntry elementos se han comprobado y todavía hay al menos un derecho de acceso solicitado que no se ha permitido explícitamente, en cuyo caso, el acceso se deniega implícitamente.

Los derechos de una cola, especificados en el parámetro rights, pueden ser cualquier combinación de lo siguiente:

• Control total

• Eliminar mensaje

• Mensaje de recepción

• Ver mensaje

• Recibir mensaje del diario

• Obtener propiedades de cola

• Establecer propiedades de cola

• Obtener permisos

• Establecer permisos

• Tomar posesión de la cola

• Escribir mensaje

La enumeración MessageQueueAccessRights representa un conjunto de marcas de bits que puede combinar mediante el operador bit a bit OR para compilar el parámetro rights.

Con esta sobrecarga, solo puede conceder permisos; no puede revocarlos ni denegarlos. Debe usar una sobrecarga diferente para conceder explícitamente cualquier AccessControlEntryType distinto de Allow.

En la tabla siguiente se muestra si este método está disponible en varios modos de grupo de trabajo.

Consulte también

• 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

Excepciones

Ejemplos

En el ejemplo de código siguiente se muestra el 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);

Comentarios

Use esta sobrecarga para conceder, denegar o revocar derechos especificados para un usuario individual. El usuario puede ser cualquier administrador de confianza válido, que incluye usuarios individuales, grupos de usuarios o un equipo. Si el usuario es individual, use el formato DOMAIN\user para el parámetro user. Puede especificar "." para el parámetro user para indicar el equipo local.

Los permisos que asigne a través de SetPermissions agregar derechos a la lista existente. De forma predeterminada, el creador de una cola pública o privada tiene control total y el grupo de dominio Todos tienen permiso para obtener propiedades de cola, obtener permisos y escribir en la cola. Al llamar a SetPermissions, la información de usuarios y permisos se anexa a la parte inferior de la lista existente.

El sistema examina cada AccessControlEntry en secuencia hasta que se produzca uno de los siguientes eventos:

• Un AccessControlEntry denegado de acceso deniega explícitamente cualquiera de los derechos de acceso solicitados a uno de los administradores enumerados en el token de acceso del subproceso.

• Uno o varios elementos de acceso permitidos AccessControlEntry para los administradores enumerados en el token de acceso del subproceso conceden explícitamente todos los derechos de acceso solicitados.

• Todos los AccessControlEntry elementos se han comprobado y todavía hay al menos un derecho de acceso solicitado que no se ha permitido explícitamente, en cuyo caso, el acceso se deniega implícitamente.

Los derechos de una cola, especificados en el parámetro rights, pueden ser cualquier combinación de lo siguiente:

• Control total

• Eliminar mensaje

• Mensaje de recepción

• Ver mensaje

• Recibir mensaje del diario

• Obtener propiedades de cola

• Establecer propiedades de cola

• Obtener permisos

• Establecer permisos

• Tomar posesión de la cola

• Escribir mensaje

La enumeración MessageQueueAccessRights representa un conjunto de marcas de bits que puede combinar mediante el operador bit a bit OR para compilar el parámetro rights.

En la tabla siguiente se muestra si este método está disponible en varios modos de grupo de trabajo.

Consulte también

• ResetPermissions()
• Trustee
• MessageQueueAccessRights
• AccessControlEntry