MessageQueue.SetPermissions MessageQueue.SetPermissions MessageQueue.SetPermissions MessageQueue.SetPermissions Method

Definición

Agrega permisos al conjunto actual.Adds permissions to the current set. De este modo, se controla quién tiene derechos de acceso a las propiedades y a los mensajes de la cola.This controls who has access rights to queue properties and messages in the queue.

Sobrecargas

SetPermissions(AccessControlList) SetPermissions(AccessControlList) SetPermissions(AccessControlList) SetPermissions(AccessControlList)

Asigna derechos de acceso a la cola de acuerdo con el contenido de una lista de control de acceso.Assigns access rights to the queue based on the contents of an access control list.

SetPermissions(MessageQueueAccessControlEntry) SetPermissions(MessageQueueAccessControlEntry) SetPermissions(MessageQueueAccessControlEntry) SetPermissions(MessageQueueAccessControlEntry)

Asigna derechos de acceso a la cola basándose en el contenido de una entrada de control de acceso.Assigns access rights to the queue based on the contents of an access control entry.

SetPermissions(String, MessageQueueAccessRights) SetPermissions(String, MessageQueueAccessRights) SetPermissions(String, MessageQueueAccessRights) SetPermissions(String, MessageQueueAccessRights)

Concede a un equipo, a un grupo o a un usuario los derechos de acceso especificados.Gives a computer, group, or user the specified access rights.

SetPermissions(String, MessageQueueAccessRights, AccessControlEntryType) SetPermissions(String, MessageQueueAccessRights, AccessControlEntryType) SetPermissions(String, MessageQueueAccessRights, AccessControlEntryType) 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).Gives a computer, group, or user the specified access rights, with the specified access control type (allow, deny, revoke, or set).

SetPermissions(AccessControlList) SetPermissions(AccessControlList) SetPermissions(AccessControlList) SetPermissions(AccessControlList)

Asigna derechos de acceso a la cola de acuerdo con el contenido de una lista de control de acceso.Assigns access rights to the queue based on the contents of an access control list.

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 AccessControlList AccessControlList 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.A AccessControlList that contains one or more access control entries that specify the trustees and the permissions to grant.

Excepciones

Error al obtener acceso a un método de Message Queuing.An error occurred when accessing a Message Queuing method.

Ejemplos

En el siguiente ejemplo de código se muestra el uso de SetPermissions(AccessControlList).The following code example demonstrates the use of 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

Utilice esta sobrecarga para conceder, denegar o revocar los derechos mediante el uso de una colección de entradas de control de acceso para especificar la información de confianza y permisos.Use this overload to grant, deny, or revoke rights by using a collection of access control entries to specify trustee and permissions information. Esto sirve, por ejemplo, para conceder permisos a varios usuarios al mismo tiempo.This is used, for example, to grant permissions to multiple users at the same time.

El Administrador de confianza que se especifica al construir el ace parámetro puede ser un usuario individual, un grupo de usuarios o un equipo.The trustee you specify when you construct the ace parameter can be an individual user, a group of users, or a computer. Si el Administrador de confianza es una persona, use el formato DOMAIN \ user.If the trustee is an individual, use the format DOMAIN\user. Puede especificar "." para el Administrador de confianza indicar el equipo local.You can specify "." for the trustee to indicate the local computer.

Los permisos que asigne a través de SetPermissions agregar derechos a la lista existente.The permissions you assign through SetPermissions add rights to the existing list. De forma predeterminada, el creador de una cola pública o privada tiene control total y el grupo de dominio todos tiene permiso para obtener propiedades de la cola, obtener permisos y escribir en la cola.By default, the creator of a public or private queue has full control, and the domain group Everyone has permission to get queue properties, get permissions, and write to the queue. Cuando se llama a SetPermissions, la información de permisos de usuario y se anexa a la parte inferior de la lista existente.When you call SetPermissions, the user and permissions information is appended to the bottom of the existing list.

El sistema examina cada AccessControlEntry en secuencia hasta que se produce uno de los siguientes eventos:The system examines each AccessControlEntry in sequence until one of the following events occurs:

  • Un acceso denegado AccessControlEntry deniega explícitamente cualquiera de los derechos de acceso solicitados a uno de los administradores de confianza que se muestran en el token de acceso del subproceso.An access-denied AccessControlEntry explicitly denies any of the requested access rights to one of the trustees listed in the thread's access token.

  • Uno o más acceso permiten AccessControlEntry elementos de confianza que figuran en el token de acceso del subproceso explícitamente concede todos los derechos de acceso solicitado.One or more access-allowed AccessControlEntry items for trustees listed in the thread's access token explicitly grant all the requested access rights.

  • Todos los AccessControlEntry elementos se han comprobado y no hay todavía al menos un derecho de acceso solicitado que no se haya permitido explícitamente, en cuyo caso, implícitamente se deniega el acceso.All AccessControlEntry items have been checked and there is still at least one requested access right that has not been explicitly allowed, in which case, access is implicitly denied.

Cuando se construye el dacl parámetro, agrega AccessControlEntry instancias a su AccessControlList colección.When you construct the dacl parameter, you add AccessControlEntry instances to your AccessControlList collection. Cuando se crea cada entrada de control de acceso, puede especificar derechos de acceso genérico o estándar.When you construct each access control entry, you can specify generic or standard access rights. Los derechos a una cola pueden ser cualquier combinación de las siguientes acciones:The rights to a queue can be any combination of the following:

  • EliminarDelete

  • Seguridad de lecturaRead Security

  • Seguridad de escrituraWrite Security

  • SincronizarSynchronize

  • Modificar propietarioModify Owner

  • LeerRead

  • WriteWrite

  • EjecutarExecute

  • ObligatorioRequired

  • TodasAll

  • NingunaNone

Estos derechos son un conjunto de marcadores de bits que se pueden combinar mediante el operador OR bit a bit.These rights are a set of bit flags that you can combine using the OR bitwise operator.

  • Control total.Full Control

  • Eliminar mensajeDelete Message

  • Recibir mensajeReceive Message

  • Inspeccionar mensajePeek Message

  • Recibir mensajes del diarioReceive Journal Message

  • Obtener propiedades de colaGet Queue Properties

  • Establecer propiedades de colaSet Queue Properties

  • Obtener permisosGet Permissions

  • Establecimiento de permisosSet Permissions

  • Tomar posesión de la colaTake Queue Ownership

  • Escribir mensajeWrite Message

En la tabla siguiente se muestra si este método está disponible en los distintos modos de grupo de trabajo.The following table shows whether this method is available in various Workgroup modes.

Modo de grupo de trabajoWorkgroup mode DisponibleAvailable
Equipo localLocal computer Yes
Equipo local y el nombre de formato directoLocal computer and direct format name Yes
Equipo remotoRemote computer NoNo
Equipo remoto y el nombre de formato directoRemote computer and direct format name NoNo
Consulte también:

SetPermissions(MessageQueueAccessControlEntry) SetPermissions(MessageQueueAccessControlEntry) SetPermissions(MessageQueueAccessControlEntry) SetPermissions(MessageQueueAccessControlEntry)

Asigna derechos de acceso a la cola basándose en el contenido de una entrada de control de acceso.Assigns access rights to the queue based on the contents of an access control entry.

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 MessageQueueAccessControlEntry MessageQueueAccessControlEntry

MessageQueueAccessControlEntry que especifica un usuario, un tipo de acceso y un tipo de permiso.A MessageQueueAccessControlEntry that specifies a user, an access type, and a permission type.

Excepciones

Error al obtener acceso a un método de Message Queuing.An error occurred when accessing a Message Queuing method.

Ejemplos

En el siguiente ejemplo de código se muestra el uso de SetPermissions(MessageQueueAccessControlEntry).The following code example demonstrates the use of 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

Utilice esta sobrecarga para conceder, denegar o revocar los derechos mediante el uso de una entrada de control de acceso para especificar el Administrador de confianza y la información de derechos.Use this overload to grant, deny, or revoke rights by using an access control entry to specify trustee and rights information.

El Administrador de confianza que se especifica al construir el ace parámetro puede ser un usuario individual, un grupo de usuarios o un equipo.The trustee you specify when you construct the ace parameter can be an individual user, a group of users, or a computer. Si el Administrador de confianza es una persona, use el formato DOMAIN \ user.If the trustee is an individual, use the format DOMAIN\user. Puede especificar "." para el Administrador de confianza indicar el equipo local.You can specify "." for the trustee to indicate the local computer.

Los permisos que asigne a través de SetPermissions agregar derechos a la lista existente.The permissions you assign through SetPermissions add rights to the existing list. De forma predeterminada, el creador de una cola pública o privada tiene control total y el grupo de dominio todos tiene permiso para obtener propiedades de la cola, obtener permisos y escribir en la cola.By default, the creator of a public or private queue has full control, and the domain group Everyone has permission to get queue properties, get permissions, and write to the queue. Cuando se llama a SetPermissions, la información de permisos de usuario y se anexa a la parte inferior de la lista existente.When you call SetPermissions, the user and permissions information is appended to the bottom of the existing list.

El sistema examina cada AccessControlEntry en secuencia hasta que se produce uno de los siguientes eventos:The system examines each AccessControlEntry in sequence until one of the following events occurs:

  • Un acceso denegado AccessControlEntry deniega explícitamente cualquiera de los derechos de acceso solicitados a uno de los administradores de confianza que se muestran en el token de acceso del subproceso.An access-denied AccessControlEntry explicitly denies any of the requested access rights to one of the trustees listed in the thread's access token.

  • Uno o más acceso permiten AccessControlEntry elementos de confianza que figuran en el token de acceso del subproceso explícitamente concede todos los derechos de acceso solicitado.One or more access-allowed AccessControlEntry items for trustees listed in the thread's access token explicitly grant all the requested access rights.

  • Todos los AccessControlEntry elementos se han comprobado y no hay todavía al menos un derecho de acceso solicitado que no se haya permitido explícitamente, en cuyo caso, implícitamente se deniega el acceso.All AccessControlEntry items have been checked and there is still at least one requested access right that has not been explicitly allowed, in which case, access is implicitly denied.

Los derechos a una cola, que se especifica en el rights parámetro al construir su MessageQueueAccessControlEntry, puede ser cualquier combinación de las siguientes acciones:The rights to a queue, which you specify in the rights parameter when you construct your MessageQueueAccessControlEntry, can be any combination of the following:

  • Control total.Full Control

  • Eliminar mensajeDelete Message

  • Recibir mensajeReceive Message

  • Inspeccionar mensajePeek Message

  • Recibir mensajes del diarioReceive Journal Message

  • Obtener propiedades de colaGet Queue Properties

  • Establecer propiedades de colaSet Queue Properties

  • Obtener permisosGet Permissions

  • Establecimiento de permisosSet Permissions

  • Tomar posesión de la colaTake Queue Ownership

  • Escribir mensajeWrite Message

El rights parámetro especificado en el constructor para la ace parámetro es un indicador de la MessageQueueAccessRights enumeración.The rights parameter you specify in the constructor for the ace parameter is a flag of the MessageQueueAccessRights enumeration. Representa un conjunto de marcas de bits que se pueden combinar mediante el operador bit a bit al construir el rights parámetro.It represents a set of bit flags that you can combine using the bitwise operator OR when you build the rights parameter.

En la tabla siguiente se muestra si este método está disponible en los distintos modos de grupo de trabajo.The following table shows whether this method is available in various Workgroup modes.

Modo de grupo de trabajoWorkgroup mode DisponibleAvailable
Equipo localLocal computer Yes
Equipo local y el nombre de formato directoLocal computer and direct format name Yes
Equipo remotoRemote computer NoNo
Equipo remoto y el nombre de formato directoRemote computer and direct format name NoNo
Consulte también:

SetPermissions(String, MessageQueueAccessRights) SetPermissions(String, MessageQueueAccessRights) SetPermissions(String, MessageQueueAccessRights) SetPermissions(String, MessageQueueAccessRights)

Concede a un equipo, a un grupo o a un usuario los derechos de acceso especificados.Gives a computer, group, or user the specified access rights.

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 String String String

Individuo, grupo o equipo que obtiene derechos adicionales en la cola.The individual, group, or computer that gets additional rights to the queue.

rights
MessageQueueAccessRights MessageQueueAccessRights MessageQueueAccessRights MessageQueueAccessRights

MessageQueueAccessRights que indica el conjunto de derechos de cola que asigna Message Queuing al parámetro user pasado.A MessageQueueAccessRights that indicates the set of rights to the queue that Message Queuing assigns to the user passed in.

Excepciones

El valor de user es null.The user is null.

Error al obtener acceso a un método de Message Queuing.An error occurred when accessing a Message Queuing method.

Ejemplos

En el siguiente ejemplo de código se muestra el uso de SetPermissions(String, MessageQueueAccessRights).The following code example demonstrates the use of 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

Utilice esta sobrecarga para conceder los derechos especificados a un usuario individual.Use this overload to grant specified rights to an individual user. El usuario puede ser cualquier usuario de confianza válido, que incluye los usuarios individuales, grupos de usuarios o un equipo.The user can be any valid trustee, which includes individual users, groups of users, or a computer. Si el usuario es un usuario individual, use el formato DOMAIN \ user para el user parámetro.If the user is an individual, use the format DOMAIN\user for the user parameter. Puede especificar "." para el user parámetro para indicar el equipo local.You can specify "." for the user parameter to indicate the local computer.

Los permisos que asigne a través de SetPermissions agregar derechos a la lista existente.The permissions you assign through SetPermissions add rights to the existing list. De forma predeterminada, el creador de una cola pública o privada tiene control total y el grupo de dominio todos tiene permiso para obtener propiedades de la cola, obtener permisos y escribir en la cola.By default, the creator of a public or private queue has full control, and the domain group Everyone has permission to get queue properties, get permissions, and write to the queue. Cuando se llama a SetPermissions, la información de permisos de usuario y se anexa a la parte inferior de la lista existente.When you call SetPermissions, the user and permissions information is appended to the bottom of the existing list.

El sistema examina cada AccessControlEntry en secuencia hasta que se produce uno de los siguientes eventos:The system examines each AccessControlEntry in sequence until one of the following events occurs:

  • Un acceso denegado AccessControlEntry deniega explícitamente cualquiera de los derechos de acceso solicitados a uno de los administradores de confianza que se muestran en el token de acceso del subproceso.An access-denied AccessControlEntry explicitly denies any of the requested access rights to one of the trustees listed in the thread's access token.

  • Uno o más acceso permiten AccessControlEntry elementos de confianza que figuran en el token de acceso del subproceso explícitamente concede todos los derechos de acceso solicitado.One or more access-allowed AccessControlEntry items for trustees listed in the thread's access token explicitly grant all the requested access rights.

  • Todos los AccessControlEntry elementos se han comprobado y no hay todavía al menos un derecho de acceso solicitado que no se haya permitido explícitamente, en cuyo caso, implícitamente se deniega el acceso.All AccessControlEntry items have been checked and there is still at least one requested access right that has not been explicitly allowed, in which case, access is implicitly denied.

Los derechos a una cola, especificado en el rights parámetro, puede ser cualquier combinación de las siguientes acciones:The rights to a queue, specified in the rights parameter, can be any combination of the following:

  • Control total.Full Control

  • Eliminar mensajeDelete Message

  • Recibir mensajeReceive Message

  • Inspeccionar mensajePeek Message

  • Recibir mensajes del diarioReceive Journal Message

  • Obtener propiedades de colaGet Queue Properties

  • Establecer propiedades de colaSet Queue Properties

  • Obtener permisosGet Permissions

  • Establecimiento de permisosSet Permissions

  • Tomar posesión de la colaTake Queue Ownership

  • Escribir mensajeWrite Message

El MessageQueueAccessRights enumeración representa un conjunto de marcas de bits que se pueden combinar mediante el operador bit a bit o para crear el rights parámetro.The MessageQueueAccessRights enumeration represents a set of bit flags that you can combine using the bitwise operator OR to build the rights parameter.

Con esta sobrecarga, solo puede conceder permisos; no se puede revocar o denegar.With this overload, you can only grant permissions; you cannot revoke or deny them. Debe utilizar una sobrecarga diferente para conceder explícitamente cualquier AccessControlEntryType distinto Allow.You must use a different overload to explicitly grant any AccessControlEntryType other than Allow.

En la tabla siguiente se muestra si este método está disponible en los distintos modos de grupo de trabajo.The following table shows whether this method is available in various Workgroup modes.

Modo de grupo de trabajoWorkgroup mode DisponibleAvailable
Equipo localLocal computer Yes
Equipo local y el nombre de formato directoLocal computer and direct format name Yes
Equipo remotoRemote computer NoNo
Equipo remoto y el nombre de formato directoRemote computer and direct format name NoNo
Consulte también:

SetPermissions(String, MessageQueueAccessRights, AccessControlEntryType) SetPermissions(String, MessageQueueAccessRights, AccessControlEntryType) SetPermissions(String, MessageQueueAccessRights, AccessControlEntryType) 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).Gives a computer, group, or user the specified access rights, with the specified access control type (allow, deny, revoke, or set).

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 String String String

Individuo, grupo o equipo que obtiene derechos adicionales en la cola.The individual, group, or computer that gets additional rights to the queue.

rights
MessageQueueAccessRights MessageQueueAccessRights MessageQueueAccessRights MessageQueueAccessRights

MessageQueueAccessRights que indica el conjunto de derechos de cola que asigna Message Queuing al parámetro user pasado.A MessageQueueAccessRights that indicates the set of rights to the queue that Message Queuing assigns to the user passed in.

entryType
AccessControlEntryType AccessControlEntryType AccessControlEntryType AccessControlEntryType

Una AccessControlEntryType que indica si se van a conceder, denegar o revocar los permisos especificados en el parámetro rights.A AccessControlEntryType that specifies whether to grant, deny, or revoke the permissions specified by the rights parameter.

Excepciones

Error al obtener acceso a un método de Message Queuing.An error occurred when accessing a Message Queuing method.

Ejemplos

En el siguiente ejemplo de código se muestra el uso de SetPermissions(String, MessageQueueAccessRights, AccessControlEntryType).The following code example demonstrates the use of 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

Utilice esta sobrecarga para conceder, denegar o revocar los derechos especificados para un usuario individual.Use this overload to grant, deny, or revoke specified rights for an individual user. El usuario puede ser cualquier usuario de confianza válido, que incluye los usuarios individuales, grupos de usuarios o un equipo.The user can be any valid trustee, which includes individual users, groups of users, or a computer. Si el usuario es un usuario individual, use el formato DOMAIN \ user para el user parámetro.If the user is an individual, use the format DOMAIN\user for the user parameter. Puede especificar "." para el user parámetro para indicar el equipo local.You can specify "." for the user parameter to indicate the local computer.

Los permisos que asigne a través de SetPermissions agregar derechos a la lista existente.The permissions you assign through SetPermissions add rights to the existing list. De forma predeterminada, el creador de una cola pública o privada tiene control total y el grupo de dominio todos tiene permiso para obtener propiedades de la cola, obtener permisos y escribir en la cola.By default, the creator of a public or private queue has full control, and the domain group Everyone has permission to get queue properties, get permissions, and write to the queue. Cuando se llama a SetPermissions, la información de permisos de usuario y se anexa a la parte inferior de la lista existente.When you call SetPermissions, the user and permissions information is appended to the bottom of the existing list.

El sistema examina cada AccessControlEntry en secuencia hasta que se produce uno de los siguientes eventos:The system examines each AccessControlEntry in sequence until one of the following events occurs:

  • Un acceso denegado AccessControlEntry deniega explícitamente cualquiera de los derechos de acceso solicitados a uno de los administradores de confianza que se muestran en el token de acceso del subproceso.An access-denied AccessControlEntry explicitly denies any of the requested access rights to one of the trustees listed in the thread's access token.

  • Uno o más acceso permiten AccessControlEntry elementos de confianza que figuran en el token de acceso del subproceso explícitamente concede todos los derechos de acceso solicitado.One or more access-allowed AccessControlEntry items for trustees listed in the thread's access token explicitly grant all the requested access rights.

  • Todos los AccessControlEntry elementos se han comprobado y no hay todavía al menos un derecho de acceso solicitado que no se haya permitido explícitamente, en cuyo caso, implícitamente se deniega el acceso.All AccessControlEntry items have been checked and there is still at least one requested access right that has not been explicitly allowed, in which case, access is implicitly denied.

Los derechos a una cola, especificado en el rights parámetro, puede ser cualquier combinación de las siguientes acciones:The rights to a queue, specified in the rights parameter, can be any combination of the following:

  • Control total.Full Control

  • Eliminar mensajeDelete Message

  • Recibir mensajeReceive Message

  • Inspeccionar mensajePeek Message

  • Recibir mensajes del diarioReceive Journal Message

  • Obtener propiedades de colaGet Queue Properties

  • Establecer propiedades de colaSet Queue Properties

  • Obtener permisosGet Permissions

  • Establecimiento de permisosSet Permissions

  • Tomar posesión de la colaTake Queue Ownership

  • Escribir mensajeWrite Message

El MessageQueueAccessRights enumeración representa un conjunto de marcas de bits que se pueden combinar mediante el operador bit a bit o para crear el rights parámetro.The MessageQueueAccessRights enumeration represents a set of bit flags that you can combine using the bitwise operator OR to build the rights parameter.

En la tabla siguiente se muestra si este método está disponible en los distintos modos de grupo de trabajo.The following table shows whether this method is available in various Workgroup modes.

Modo de grupo de trabajoWorkgroup mode DisponibleAvailable
Equipo localLocal computer Yes
Equipo local y el nombre de formato directoLocal computer and direct format name Yes
Equipo remotoRemote computer NoNo
Equipo remoto y el nombre de formato directoRemote computer and direct format name NoNo
Consulte también:

Se aplica a