MessageQueue.SetPermissions Método

Definición

Espacio de nombres:

System.Messaging

Ensamblado:

System.Messaging.dll

Agrega permisos al conjunto actual. De este modo, se controla quién tiene derechos de acceso a las propiedades y a los mensajes de la cola.

Sobrecargas

SetPermissions(AccessControlList)	Asigna derechos de acceso a la cola de acuerdo con el contenido de una lista de control de acceso.
SetPermissions(MessageQueueAccessControlEntry)	Asigna derechos de acceso a la cola basándose en el contenido de una entrada de control de acceso.
SetPermissions(String, MessageQueueAccessRights)	Concede a un equipo, a un grupo o a un usuario los derechos de acceso especificados.
SetPermissions(String, MessageQueueAccessRights, AccessControlEntryType)	Concede a un equipo, grupo o usuario los derechos de acceso especificados, con el tipo de control de acceso indicado (conceder, negar, revocar o establecer).

SetPermissions(AccessControlList)

Asigna derechos de acceso a la cola de acuerdo con el 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

Una AccessControlList que contiene una o varias entradas de control de acceso con aquellos usuarios que pueden obtener acceso y los permisos concedidos a cada uno de ellos.

Excepciones

MessageQueueException

Error al obtener acceso a un método de Message Queuing.

Ejemplos

En el siguiente ejemplo de código 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 confianza. Esto se usa, por ejemplo, para conceder permisos a varios usuarios al mismo tiempo.

El administrador de confianza que especifique al construir el ace parámetro 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 SetPermissions de la adición de 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. Cuando se llama a SetPermissions, la información de usuario y permisos se anexa a la parte inferior de la lista existente.

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

• Un acceso denegado deniega AccessControlEntry 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 permitidos AccessControlEntry para el acceso para los administradores enumerados en el token de acceso del subproceso conceden explícitamente todos los derechos de acceso solicitados.

• Se han comprobado todos los AccessControlEntry elementos 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 dacl parámetro , se agregan AccessControlEntry instancias a la AccessControlList colección. 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:

• Eliminar

• Seguridad de lectura

• Seguridad de escritura

• Sincronizar

• Modificar propietario

• Leer

• Escritura

• Execute

• Requerido

• All

• None

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

• Control total

• Eliminar mensaje

• Recibir mensaje

• Inspección de mensajes

• Recibir mensaje de Journal

• Obtener propiedades de cola

• Establecer propiedades de cola

• Obtener permisos

• Establecimiento de permisos

• Toma de propiedad 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 basándose en el 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

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

Excepciones

MessageQueueException

Error al obtener acceso a un método de Message Queuing.

Ejemplos

En el siguiente ejemplo de código 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 de confianza.

El administrador de confianza que especifique al construir el ace parámetro 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 SetPermissions de la adición de 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. Cuando se llama a SetPermissions, la información de usuario y permisos se anexa a la parte inferior de la lista existente.

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

• Un acceso denegado deniega AccessControlEntry 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 permitidos AccessControlEntry para el acceso para los administradores enumerados en el token de acceso del subproceso conceden explícitamente todos los derechos de acceso solicitados.

• Se han comprobado todos los AccessControlEntry elementos 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 se especifican en el rights parámetro al construir MessageQueueAccessControlEntry, pueden ser cualquier combinación de lo siguiente:

• Control total

• Eliminar mensaje

• Recibir mensaje

• Inspección de mensajes

• Recibir mensaje de Journal

• Obtener propiedades de cola

• Establecer propiedades de cola

• Obtener permisos

• Establecimiento de permisos

• Toma de propiedad de la cola

• Escribir mensaje

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

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)

Concede a un equipo, a un grupo o a un 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

Individuo, grupo o equipo que obtiene derechos adicionales en la cola.

rights

MessageQueueAccessRights

MessageQueueAccessRights que indica el conjunto de derechos de cola que asigna Message Queuing al parámetro user pasado.

Excepciones

ArgumentException

El valor de user es null.

MessageQueueException

Error al obtener acceso a un método de Message Queuing.

Ejemplos

En el siguiente ejemplo de código 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 válido, que incluye usuarios individuales, grupos de usuarios o un equipo. Si el usuario es individual, use el formato DOMAIN\user para el user parámetro . Puede especificar "." para el user parámetro para indicar el equipo local.

Los permisos que asigne mediante SetPermissions la adición de derechos a la lista existente. De forma predeterminada, el creador de una cola pública o privada tiene control total y el grupo de dominios Todos tienen permiso para obtener propiedades de cola, obtener permisos y escribir en la cola. Cuando se llama a SetPermissions, la información de usuario y permisos se anexa a la parte inferior de la lista existente.

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

• Un acceso denegado deniega AccessControlEntry 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 permitidos AccessControlEntry para el acceso 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 rights parámetro , pueden ser cualquier combinación de lo siguiente:

• Control total

• Eliminar mensaje

• Recibir mensaje

• Inspección de mensajes

• Recibir mensaje de Journal

• Obtener las propiedades de la cola

• Establecer las propiedades de la cola

• Obtener permisos

• Establecimiento de permisos

• Tomar la propiedad de la cola

• Escribir mensaje

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

Con esta sobrecarga, solo puede conceder permisos; no puede revocarlos ni denegarlos. Debe usar una sobrecarga diferente para conceder explícitamente a cualquier AccessControlEntryType otro que no sea 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)

Concede a un equipo, grupo o usuario los derechos de acceso especificados, con el tipo de control de acceso indicado (conceder, negar, 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

Individuo, grupo o equipo que obtiene derechos adicionales en la cola.

rights

MessageQueueAccessRights

MessageQueueAccessRights que indica el conjunto de derechos de cola que asigna Message Queuing al parámetro user pasado.

entryType

AccessControlEntryType

Una AccessControlEntryType que indica si se van a conceder, denegar o revocar los permisos especificados en el parámetro rights.

Excepciones

MessageQueueException

Error al obtener acceso a un método de Message Queuing.

Ejemplos

En el siguiente ejemplo de código 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 válido, que incluye usuarios individuales, grupos de usuarios o un equipo. Si el usuario es individual, use el formato DOMAIN\user para el user parámetro . Puede especificar "." para el user parámetro para indicar el equipo local.

Los permisos que asigne mediante SetPermissions la adición de derechos a la lista existente. De forma predeterminada, el creador de una cola pública o privada tiene control total y el grupo de dominios Todos tienen permiso para obtener propiedades de cola, obtener permisos y escribir en la cola. Cuando se llama a SetPermissions, la información de usuario y permisos se anexa a la parte inferior de la lista existente.

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

• Un acceso denegado deniega AccessControlEntry 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 permitidos AccessControlEntry para el acceso 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 rights parámetro , pueden ser cualquier combinación de lo siguiente:

• Control total

• Eliminar mensaje

• Recibir mensaje

• Inspección de mensajes

• Recibir mensaje de Journal

• Obtener las propiedades de la cola

• Establecer las propiedades de la cola

• Obtener permisos

• Establecimiento de permisos

• Tomar la propiedad de la cola

• Escribir mensaje

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

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