MessageQueue.SetPermissions Metoda

Definice

Obor názvů:

System.Messaging

Sestavení:

System.Messaging.dll

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í

SetPermissions(AccessControlList)	Přiřadí přístupová práva k frontě na základě obsahu seznamu řízení přístupu.
SetPermissions(MessageQueueAccessControlEntry)	Přiřadí přístupová práva k frontě na základě obsahu položky řízení přístupu.
SetPermissions(String, MessageQueueAccessRights)	Poskytne 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 , který obsahuje 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ě služby Ří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ý zadá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 ".", aby správce označil místní počítač.

Oprávnění, která přiřadíte prostřednictvím SetPermissions přidání práv do existujícího seznamu. Ve výchozím nastavení má autor veřejné nebo soukromé fronty úplné řízení a skupina domén Všichni má oprávnění k získání vlastností fronty, získání oprávnění a zápisu do fronty. Při volání metody SetPermissionsse informace o uživateli a oprávněních připojí na konec existujícího seznamu.

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

• Odepření AccessControlEntry přístupu explicitně odepře některému z požadovaných přístupových práv některému z správců uvedených v přístupovém tokenu vlákna.

• Jedna nebo více položek s povoleným AccessControlEntry přístupem pro správce uvedené v přístupovém tokenu vlákna explicitně udělují 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í:

• Odstranit

• Zabezpečení čtení

• Zabezpečení zápisu

• Synchronizace

• Změnit vlastníka

• Čtení

• Zápis

• Spuštěním

• Vyžadováno

• Vše

• Žádné

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

• Úplné řízení

• Odstranit zprávu

• Přijmout zprávu

• Náhled zpráva

• Přijetí Deník zprávy

• Získání vlastností fronty

• Nastavení vlastností fronty

• Získání oprávnění

• Nastavení 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	K dispozici.
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é

• ResetPermissions()
• Trustee
• AccessControlList

SetPermissions(MessageQueueAccessControlEntry)

Přiřadí přístupová práva k frontě 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

A MessageQueueAccessControlEntry , který určuje uživatele, typ přístupu a typ oprávnění.

Výjimky

MessageQueueException

Při přístupu k metodě služby Ří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

Pomocí tohoto přetížení můžete udělit, odepřít nebo odvolat práva pomocí položky řízení přístupu k určení informací o správci a právech.

Správce, který zadá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 ".", aby správce označil místní počítač.

Oprávnění, která přiřadíte prostřednictvím SetPermissions přidání práv do existujícího seznamu. Ve výchozím nastavení má autor veřejné nebo soukromé fronty úplné řízení a skupina domén Všichni má oprávnění k získání vlastností fronty, získání oprávnění a zápisu do fronty. Při volání metody SetPermissionsse informace o uživateli a oprávněních připojí na konec existujícího seznamu.

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

• Odepření AccessControlEntry přístupu explicitně odepře některému z požadovaných přístupových práv některému z správců uvedených v přístupovém tokenu vlákna.

• Jedna nebo více položek s povoleným AccessControlEntry přístupem pro správce uvedené v přístupovém tokenu vlákna explicitně udělují 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ě, která zadáte v parametru rights při vytváření MessageQueueAccessControlEntrysouboru , můžou být libovolná z následujících kombinací:

• Úplné řízení

• Odstranit zprávu

• Přijmout zprávu

• Náhled zpráva

• Přijetí Deník zprávy

• Získání vlastností fronty

• Nastavení vlastností fronty

• Získání oprávnění

• Nastavení oprávnění

• Převzetí vlastnictví fronty

• Napsat zprávu

Parametr rights , který zadáte v konstruktoru ace pro parametr, je příznakem výčtu MessageQueueAccessRights . Představuje sadu bitových příznaků, které můžete kombinovat pomocí bitového operátoru OR při sestavování 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	K dispozici.
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é

• ResetPermissions()
• Trustee
• MessageQueueAccessRights
• MessageQueueAccessControlEntry

SetPermissions(String, MessageQueueAccessRights)

Poskytne 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 k frontě.

rights

MessageQueueAccessRights

A MessageQueueAccessRights označující sadu práv k frontě, kterou služba Řízení front zpráv přiřadí předávané frontě user .

Výjimky

ArgumentException

Hodnota user je null.

MessageQueueException

Při přístupu k metodě služby Ří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 jednotlivec, použijte formát DOMAIN\user parametru.user Můžete zadat "." pro user parametr označující místní počítač.

Oprávnění, která přiřadíte prostřednictvím SetPermissions přidání práv do existujícího seznamu. Ve výchozím nastavení má tvůrce veřejné nebo privátní fronty úplné řízení a skupina domén Všichni mají oprávnění k získání vlastností fronty, získání oprávnění a zápisu do fronty. Při volání SetPermissionsse informace o uživateli a oprávněních připojí na konec existujícího seznamu.

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

• Odepřený AccessControlEntry přístup explicitně odepře jakékoli požadované přístupová práva některému z správců uvedených v přístupovém tokenu vlákna.

• Jedna nebo více položek s povoleným AccessControlEntry přístupem pro správce uvedené v přístupovém tokenu vlákna explicitně uděluje 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ě zadaná v parametru rights můžou být libovolná z následujících kombinací:

• Úplné řízení

• Odstranit zprávu

• Přijmout zprávu

• Náhled zpráva

• Přijmout zprávu Deník

• Získání vlastností fronty

• Nastavení vlastností fronty

• Získat oprávnění

• Nastavení oprávnění

• Převzetí vlastnictví fronty

• Napsat zprávu

Výčet MessageQueueAccessRights představuje sadu bitových příznaků, které můžete zkombinovat pomocí bitového 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 nebo zamítnout. Pokud chcete explicitně udělit jakékoli AccessControlEntryType jiné 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	K dispozici.
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é

• ResetPermissions()
• Trustee
• MessageQueueAccessRights

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 k frontě.

rights

MessageQueueAccessRights

A MessageQueueAccessRights označující sadu práv k frontě, kterou služba Řízení front zpráv přiřadí předávané frontě user .

entryType

AccessControlEntryType

A AccessControlEntryType , který určuje, zda se mají udělit, odepřít nebo odvolat oprávnění určená parametrem rights .

Výjimky

MessageQueueException

Při přístupu k metodě služby Ří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í, odepření nebo odvolání 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 jednotlivec, použijte formát DOMAIN\user parametru.user Můžete zadat "." pro user parametr označující místní počítač.

Oprávnění, která přiřadíte prostřednictvím SetPermissions přidání práv do existujícího seznamu. Ve výchozím nastavení má tvůrce veřejné nebo privátní fronty úplné řízení a skupina domén Všichni mají oprávnění k získání vlastností fronty, získání oprávnění a zápisu do fronty. Při volání SetPermissionsse informace o uživateli a oprávněních připojí na konec existujícího seznamu.

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

• Odepřený AccessControlEntry přístup explicitně odepře jakékoli požadované přístupová práva některému z správců uvedených v přístupovém tokenu vlákna.

• Jedna nebo více položek s povoleným AccessControlEntry přístupem pro správce uvedené v přístupovém tokenu vlákna explicitně uděluje 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ě zadaná v parametru rights můžou být libovolná z následujících kombinací:

• Úplné řízení

• Odstranit zprávu

• Přijmout zprávu

• Náhled zpráva

• Přijmout zprávu Deník

• Získání vlastností fronty

• Nastavení vlastností fronty

• Získat oprávnění

• Nastavení oprávnění

• Převzetí vlastnictví fronty

• Napsat zprávu

Výčet MessageQueueAccessRights představuje sadu bitových příznaků, které můžete zkombinovat pomocí bitového 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	K dispozici.
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é

• ResetPermissions()
• Trustee
• MessageQueueAccessRights
• AccessControlEntry