MessageQueue.SetPermissions Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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 -> unitPublic 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
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
Se aplica a
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 -> unitPublic Sub SetPermissions (ace As MessageQueueAccessControlEntry)Parámetros
MessageQueueAccessControlEntry que especifica un usuario, un tipo de acceso y un tipo de permiso.
Excepciones
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
Se aplica a
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 -> unitPublic 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
El valor de user es null.
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
Se aplica a
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 -> unitPublic 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
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
Se aplica a
Comentarios
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea: https://aka.ms/ContentUserFeedback.
Enviar y ver comentarios de