MessageQueue.SetPermissions Metoda

Definice

Obor názvů:: System.Messaging

Sestavení:: System.Messaging.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

Přidá oprávnění k aktuální sadě. Určuje, kdo má přístupová práva k vlastnostem fronty a zprávám ve frontě.

Přetížení

Name	Description
SetPermissions(AccessControlList)	Přiřadí přístupová práva k frontě na základě obsahu seznamu řízení přístupu.
SetPermissions(MessageQueueAccessControlEntry)	Přiřadí frontě přístupová práva na základě obsahu položky řízení přístupu.
SetPermissions(String, MessageQueueAccessRights)	Udělí počítači, skupině nebo uživateli zadaná přístupová práva.
SetPermissions(String, MessageQueueAccessRights, AccessControlEntryType)	Poskytne počítači, skupině nebo uživateli zadaná přístupová práva se zadaným typem řízení přístupu (povolit, odepřít, odvolat nebo nastavit).

SetPermissions(AccessControlList)

Přiřadí přístupová práva k frontě na základě obsahu seznamu řízení přístupu.

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)

Parametry

dacl: AccessControlList

A AccessControlList obsahující jednu nebo více položek řízení přístupu, které určují správce a oprávnění k udělení.

Výjimky

MessageQueueException

Při přístupu k metodě řízení front zpráv došlo k chybě.

Příklady

Následující příklad kódu ukazuje použití 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);

Poznámky

Pomocí tohoto přetížení můžete udělit, odepřít nebo odvolat práva pomocí kolekce položek řízení přístupu k určení informací o správci a oprávněních. Používá se například k udělení oprávnění více uživatelům najednou.

Správce, který určíte při vytváření parametru ace , může být individuální uživatel, skupina uživatelů nebo počítač. Pokud je správcem jednotlivec, použijte formát DOMAIN\user. Můžete zadat "." pro správce, který bude indikovat místní počítač.

Oprávnění, která přiřadíte prostřednictvím SetPermissions přidání práv k existujícímu seznamu. Ve výchozím nastavení má tvůrce veřejné nebo privátní fronty úplnou kontrolu a skupina domén Všichni mají oprávnění získat vlastnosti fronty, získat oprávnění a zapisovat do fronty. Při volání SetPermissionsse informace o uživateli a oprávněních připojí do dolní části existujícího seznamu.

Systém postupně zkoumá jednotlivé AccessControlEntry události, dokud nedojde k jedné z následujících událostí:

Odepření přístupu AccessControlEntry explicitně odmítne všechna požadovaná přístupová práva některému z důvěryhodných správců uvedených v přístupovém tokenu vlákna.
Jedna nebo více položek povolených AccessControlEntry pro správce uvedené v přístupovém tokenu vlákna explicitně udělte všechna požadovaná přístupová práva.
Všechny AccessControlEntry položky byly zkontrolovány a stále existuje alespoň jedno požadované přístupové právo, které nebylo explicitně povoleno, v takovém případě je přístup implicitně odepřen.

Při vytváření parametru dacl přidáte AccessControlEntry instance do AccessControlList kolekce. Při vytváření každé položky řízení přístupu můžete zadat obecná nebo standardní přístupová práva. Práva k frontě můžou být libovolná z následujících kombinací:

Vymazat
Zabezpečení čtení
Zabezpečení zápisu
Synchronize
Změnit vlastníka
Číst
Napiš
Provést
Povinné
Všechno
None

Tato práva jsou sada bitových příznaků, které můžete kombinovat pomocí bitového operátoru OR.

Plná kontrola
Smazat zprávu
Přijmout zprávu
Náhled zprávy
Přijmout zprávu deníku
Získání vlastností fronty
Nastavení vlastností fronty
Získání oprávnění
Nastavit oprávnění
Převzetí vlastnictví fronty
Napsat zprávu

Následující tabulka ukazuje, zda je tato metoda k dispozici v různých režimech pracovní skupiny.

Režim pracovní skupiny	Available
Místní počítač	Yes
Název místního počítače a přímého formátu	Yes
Vzdálený počítač	No
Název vzdáleného počítače a přímého formátu	No

Viz také

Platí pro

SetPermissions(MessageQueueAccessControlEntry)

Přiřadí frontě přístupová práva na základě obsahu položky řízení přístupu.

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)

Parametry

ace: MessageQueueAccessControlEntry

Určuje MessageQueueAccessControlEntry uživatele, typ přístupu a typ oprávnění.

Výjimky

MessageQueueException

Při přístupu k metodě řízení front zpráv došlo k chybě.

Příklady

Následující příklad kódu ukazuje použití 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);

Poznámky

Toto přetížení použijte k udělení, zamítnutí nebo odvolání práv pomocí položky řízení přístupu k určení informací o správci a právech.

Systém postupně zkoumá jednotlivé AccessControlEntry události, dokud nedojde k jedné z následujících událostí:

Odepření přístupu AccessControlEntry explicitně odmítne všechna požadovaná přístupová práva některému z důvěryhodných správců uvedených v přístupovém tokenu vlákna.
Jedna nebo více položek povolených AccessControlEntry pro správce uvedené v přístupovém tokenu vlákna explicitně udělte všechna požadovaná přístupová práva.
Všechny AccessControlEntry položky byly zkontrolovány a stále existuje alespoň jedno požadované přístupové právo, které nebylo explicitně povoleno, v takovém případě je přístup implicitně odepřen.

Práva k frontě, kterou zadáte v parametru rights při vytváření MessageQueueAccessControlEntry, může být libovolná kombinace následujících:

Plná kontrola
Smazat zprávu
Přijmout zprávu
Náhled zprávy
Přijmout zprávu deníku
Získání vlastností fronty
Nastavení vlastností fronty
Získání oprávnění
Nastavit oprávnění
Převzetí vlastnictví fronty
Napsat zprávu

Parametr rights , který zadáte v konstruktoru ace pro parametr, je příznak výčtu MessageQueueAccessRights . Představuje sadu bitových příznaků, které můžete kombinovat pomocí bitové operátoru OR při sestavení parametru rights .

Následující tabulka ukazuje, zda je tato metoda k dispozici v různých režimech pracovní skupiny.

Režim pracovní skupiny	Available
Místní počítač	Yes
Název místního počítače a přímého formátu	Yes
Vzdálený počítač	No
Název vzdáleného počítače a přímého formátu	No

Viz také

Platí pro

SetPermissions(String, MessageQueueAccessRights)

Udělí počítači, skupině nebo uživateli zadaná přístupová práva.

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)

Parametry

user: String

Jednotlivec, skupina nebo počítač, který získá další práva do fronty.

rights: MessageQueueAccessRights

A MessageQueueAccessRights , který označuje sadu práv pro frontu, kterou služba Řízení front zpráv přiřadí předávané službě user .

Výjimky

ArgumentException

To user je null.

MessageQueueException

Při přístupu k metodě řízení front zpráv došlo k chybě.

Příklady

Následující příklad kódu ukazuje použití 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);

Poznámky

Toto přetížení použijte k udělení zadaných práv jednotlivým uživatelům. Uživatel může být libovolný platný správce, který zahrnuje jednotlivé uživatele, skupiny uživatelů nebo počítač. Pokud je uživatel individuální, použijte formát DOMAIN\user parametru.user Můžete zadat "." parametru user , který označuje místní počítač.

Systém postupně zkoumá jednotlivé AccessControlEntry události, dokud nedojde k jedné z následujících událostí:

Odepření přístupu AccessControlEntry explicitně odmítne všechna požadovaná přístupová práva některému z důvěryhodných správců uvedených v přístupovém tokenu vlákna.
Jedna nebo více položek povolených AccessControlEntry pro správce uvedené v přístupovém tokenu vlákna explicitně udělte všechna požadovaná přístupová práva.
Všechny AccessControlEntry položky byly zkontrolovány a stále existuje alespoň jedno požadované přístupové právo, které nebylo explicitně povoleno, v takovém případě je přístup implicitně odepřen.

Práva na frontu zadanou v parametru rights můžou být libovolná z následujících kombinací:

Plná kontrola
Smazat zprávu
Přijmout zprávu
Náhled zprávy
Přijmout zprávu deníku
Získání vlastností fronty
Nastavení vlastností fronty
Získání oprávnění
Nastavit oprávnění
Převzetí vlastnictví fronty
Napsat zprávu

Výčet MessageQueueAccessRights představuje sadu bitových příznaků, které můžete kombinovat pomocí bitové operátoru OR k sestavení parametru rights .

S tímto přetížením můžete udělit pouze oprávnění; nemůžete je odvolat ani odepřít. Musíte použít jiné přetížení explicitně udělit jiné AccessControlEntryType než Allow.

Následující tabulka ukazuje, zda je tato metoda k dispozici v různých režimech pracovní skupiny.

Režim pracovní skupiny	Available
Místní počítač	Yes
Název místního počítače a přímého formátu	Yes
Vzdálený počítač	No
Název vzdáleného počítače a přímého formátu	No

Viz také

Platí pro

SetPermissions(String, MessageQueueAccessRights, AccessControlEntryType)

Poskytne počítači, skupině nebo uživateli zadaná přístupová práva se zadaným typem řízení přístupu (povolit, odepřít, odvolat nebo nastavit).

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)

Parametry

user: String

Jednotlivec, skupina nebo počítač, který získá další práva do fronty.

rights: MessageQueueAccessRights

A MessageQueueAccessRights , který označuje sadu práv pro frontu, kterou služba Řízení front zpráv přiřadí předávané službě user .

entryType: AccessControlEntryType

Určuje AccessControlEntryType , zda se mají udělit, odepřít nebo odvolat oprávnění zadaná parametrem rights .

Výjimky

MessageQueueException

Při přístupu k metodě řízení front zpráv došlo k chybě.

Příklady

Následující příklad kódu ukazuje použití 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);

Poznámky

Toto přetížení použijte k udělení, zamítnutí nebo odvolání zadaných práv pro jednotlivé uživatele. Uživatel může být libovolný platný správce, který zahrnuje jednotlivé uživatele, skupiny uživatelů nebo počítač. Pokud je uživatel individuální, použijte formát DOMAIN\user parametru.user Můžete zadat "." parametru user , který označuje místní počítač.

Systém postupně zkoumá jednotlivé AccessControlEntry události, dokud nedojde k jedné z následujících událostí:

Odepření přístupu AccessControlEntry explicitně odmítne všechna požadovaná přístupová práva některému z důvěryhodných správců uvedených v přístupovém tokenu vlákna.
Jedna nebo více položek povolených AccessControlEntry pro správce uvedené v přístupovém tokenu vlákna explicitně udělte všechna požadovaná přístupová práva.
Všechny AccessControlEntry položky byly zkontrolovány a stále existuje alespoň jedno požadované přístupové právo, které nebylo explicitně povoleno, v takovém případě je přístup implicitně odepřen.

Práva na frontu zadanou v parametru rights můžou být libovolná z následujících kombinací:

Plná kontrola
Smazat zprávu
Přijmout zprávu
Náhled zprávy
Přijmout zprávu deníku
Získání vlastností fronty
Nastavení vlastností fronty
Získání oprávnění
Nastavit oprávnění
Převzetí vlastnictví fronty
Napsat zprávu

Výčet MessageQueueAccessRights představuje sadu bitových příznaků, které můžete kombinovat pomocí bitové operátoru OR k sestavení parametru rights .

Následující tabulka ukazuje, zda je tato metoda k dispozici v různých režimech pracovní skupiny.

Režim pracovní skupiny	Available
Místní počítač	Yes
Název místního počítače a přímého formátu	Yes
Vzdálený počítač	No
Název vzdáleného počítače a přímého formátu	No

Viz také

Platí pro

Váš názor

Byla tato stránka užitečná?