MessageQueue.SetPermissions Método

Definición

Espacio de nombres:

System.Messaging

Ensamblado:

System.Messaging.dll

Agrega permisos al conjunto actual. Esto controla quién tiene derechos de acceso a las propiedades y mensajes de la cola.

Sobrecargas

SetPermissions(AccessControlList)	Asigna derechos de acceso a la cola en función del contenido de una lista de control de acceso.
SetPermissions(MessageQueueAccessControlEntry)	Asigna derechos de acceso a la cola en función del contenido de una entrada de control de acceso.
SetPermissions(String, MessageQueueAccessRights)	Proporciona a un equipo, grupo o usuario los derechos de acceso especificados.
SetPermissions(String, MessageQueueAccessRights, AccessControlEntryType)	Proporciona a un equipo, grupo o usuario los derechos de acceso especificados, con el tipo de control de acceso especificado (permitir, denegar, revocar o establecer).

SetPermissions(AccessControlList)

Asigna derechos de acceso a la cola en función del contenido de una lista de control de acceso.

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

dacl

AccessControlList

Un AccessControlList que contiene una o varias entradas de control de acceso que especifican los administradores y los permisos que se van a conceder.

Excepciones

MessageQueueException

Error al acceder a un método Message Queuing.

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.

Modo de grupo de trabajo	Disponible
Equipo local	Sí
Equipo local y nombre de formato directo	Sí
Equipo remoto	No
Equipo remoto y nombre de formato directo	No

Consulte también

• ResetPermissions()
• Trustee
• AccessControlList

SetPermissions(MessageQueueAccessControlEntry)

Asigna derechos de acceso a la cola en función del contenido de una entrada de control de acceso.

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

ace

MessageQueueAccessControlEntry

Un MessageQueueAccessControlEntry que especifica un usuario, un tipo de acceso y un tipo de permiso.

Excepciones

MessageQueueException

Error al acceder a un método Message Queuing.

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.

Modo de grupo de trabajo	Disponible
Equipo local	Sí
Equipo local y nombre de formato directo	Sí
Equipo remoto	No
Equipo remoto y nombre de formato directo	No

Consulte también

• ResetPermissions()
• Trustee
• MessageQueueAccessRights
• MessageQueueAccessControlEntry

SetPermissions(String, MessageQueueAccessRights)

Proporciona a un equipo, grupo o usuario los derechos de acceso especificados.

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

user

String

El usuario, el grupo o el equipo que obtiene derechos adicionales a la cola.

rights

MessageQueueAccessRights

Un MessageQueueAccessRights que indica el conjunto de derechos en la cola que Message Queuing asigna al user pasado.

Excepciones

ArgumentException

El user es null.

MessageQueueException

Error al acceder a un método Message Queuing.

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.

Modo de grupo de trabajo	Disponible
Equipo local	Sí
Equipo local y nombre de formato directo	Sí
Equipo remoto	No
Equipo remoto y nombre de formato directo	No

Consulte también

• ResetPermissions()
• Trustee
• MessageQueueAccessRights

SetPermissions(String, MessageQueueAccessRights, AccessControlEntryType)

Proporciona a un equipo, grupo o usuario los derechos de acceso especificados, con el tipo de control de acceso especificado (permitir, denegar, revocar o establecer).

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

user

String

El usuario, el grupo o el equipo que obtiene derechos adicionales a la cola.

rights

MessageQueueAccessRights

Un MessageQueueAccessRights que indica el conjunto de derechos en la cola que Message Queuing asigna al user pasado.

entryType

AccessControlEntryType

Un AccessControlEntryType que especifica si se deben conceder, denegar o revocar los permisos especificados por el parámetro rights.

Excepciones

MessageQueueException

Error al acceder a un método Message Queuing.

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.

Modo de grupo de trabajo	Disponible
Equipo local	Sí
Equipo local y nombre de formato directo	Sí
Equipo remoto	No
Equipo remoto y nombre de formato directo	No

Consulte también

• ResetPermissions()
• Trustee
• MessageQueueAccessRights
• AccessControlEntry