MessageQueue.SetPermissions Metod

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)

Parametrar

Undantag

Exempel

I följande kodexempel visas användningen av 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);

Kommentarer

Använd den här överlagringen för att bevilja, neka eller återkalla rättigheter med hjälp av en samling åtkomstkontrollposter för att ange information om förvaltare och behörigheter. Detta används till exempel för att bevilja behörigheter till flera användare samtidigt.

Den förvaltare som du anger när du skapar parametern ace kan vara en enskild användare, en grupp användare eller en dator. Om förvaltaren är en individ använder du formatet DOMAIN\user. Du kan ange "" för förvaltaren för att ange den lokala datorn.

De behörigheter som du tilldelar genom SetPermissions att lägga till rättigheter till den befintliga listan. Som standard har skaparen av en offentlig eller privat kö fullständig kontroll och domängruppen Alla har behörighet att hämta köegenskaper, hämta behörigheter och skriva till kön. När du anropar SetPermissionsläggs användar- och behörighetsinformationen till längst ned i den befintliga listan.

Systemet undersöker var och AccessControlEntry en i följd tills någon av följande händelser inträffar:

• En nekad AccessControlEntry åtkomst nekar uttryckligen någon av de begärda åtkomsträttigheterna till en av de förvaltare som anges i trådens åtkomsttoken.

• Ett eller flera åtkomst tillåtna AccessControlEntry objekt för förvaltare som anges i trådens åtkomsttoken beviljar uttryckligen alla begärda åtkomsträttigheter.

• Alla AccessControlEntry objekt har kontrollerats och det finns fortfarande minst en begärd åtkomsträtt som inte uttryckligen har tillåtits, och i så fall nekas åtkomst implicit.

När du skapar parametern dacl lägger du till AccessControlEntry instanser i samlingen AccessControlList . När du skapar varje åtkomstkontrollpost kan du ange allmänna eller standardbehörigheter för åtkomst. Rättigheterna till en kö kan vara valfri kombination av följande:

• Radera

• Läs säkerhet

• Skrivsäkerhet

• Synchronize

• Ändra ägare

• Läsa

• Skriv

• Verkställ

• Obligatoriskt

• Allt

• Ingen

Dessa rättigheter är en uppsättning bitflaggor som du kan kombinera med operatorn OR bitwise.

• Fullständig kontroll

• Ta bort meddelande

• Ta emot meddelande

• Granska meddelande

• Ta emot journalmeddelande

• Hämta köegenskaper

• Ange köegenskaper

• Hämta behörigheter

• Ange behörigheter

• Ta köägarskap

• Skriv meddelande

I följande tabell visas om den här metoden är tillgänglig i olika arbetsgruppslägen.

Se även

• ResetPermissions()
• Trustee
• AccessControlList

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)

Parametrar

Undantag

Exempel

I följande kodexempel visas användningen av 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);

Kommentarer

Använd den här överlagringen för att bevilja, neka eller återkalla rättigheter med hjälp av en åtkomstkontrollpost för att ange information om förvaltare och rättigheter.

Den förvaltare som du anger när du skapar parametern ace kan vara en enskild användare, en grupp användare eller en dator. Om förvaltaren är en individ använder du formatet DOMAIN\user. Du kan ange "" för förvaltaren för att ange den lokala datorn.

De behörigheter som du tilldelar genom SetPermissions att lägga till rättigheter till den befintliga listan. Som standard har skaparen av en offentlig eller privat kö fullständig kontroll och domängruppen Alla har behörighet att hämta köegenskaper, hämta behörigheter och skriva till kön. När du anropar SetPermissionsläggs användar- och behörighetsinformationen till längst ned i den befintliga listan.

Systemet undersöker var och AccessControlEntry en i följd tills någon av följande händelser inträffar:

• En nekad AccessControlEntry åtkomst nekar uttryckligen någon av de begärda åtkomsträttigheterna till en av de förvaltare som anges i trådens åtkomsttoken.

• Ett eller flera åtkomst tillåtna AccessControlEntry objekt för förvaltare som anges i trådens åtkomsttoken beviljar uttryckligen alla begärda åtkomsträttigheter.

• Alla AccessControlEntry objekt har kontrollerats och det finns fortfarande minst en begärd åtkomsträtt som inte uttryckligen har tillåtits, och i så fall nekas åtkomst implicit.

Rättigheterna till en kö, som du anger i parametern rights när du skapar , MessageQueueAccessControlEntrykan vara valfri kombination av följande:

• Fullständig kontroll

• Ta bort meddelande

• Ta emot meddelande

• Granska meddelande

• Ta emot journalmeddelande

• Hämta köegenskaper

• Ange köegenskaper

• Hämta behörigheter

• Ange behörigheter

• Ta köägarskap

• Skriv meddelande

Parametern rights som du anger i konstruktorn för parametern ace är en flagga för MessageQueueAccessRights uppräkningen. Den representerar en uppsättning bitflaggor som du kan kombinera med hjälp av bitvis-operatorn ELLER när du skapar parametern rights .

I följande tabell visas om den här metoden är tillgänglig i olika arbetsgruppslägen.

Se även

• ResetPermissions()
• Trustee
• MessageQueueAccessRights
• MessageQueueAccessControlEntry

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)

Parametrar

Undantag

Exempel

I följande kodexempel visas användningen av 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);

Kommentarer

Använd den här överlagringen för att bevilja angivna rättigheter till en enskild användare. Användaren kan vara valfri giltig förvaltare, vilket inkluderar enskilda användare, grupper av användare eller en dator. Om användaren är en individ använder du formatet DOMAIN\user för parametern.user Du kan ange "." för parametern user för att ange den lokala datorn.

De behörigheter som du tilldelar genom SetPermissions att lägga till rättigheter till den befintliga listan. Som standard har skaparen av en offentlig eller privat kö fullständig kontroll och domängruppen Alla har behörighet att hämta köegenskaper, hämta behörigheter och skriva till kön. När du anropar SetPermissionsläggs användar- och behörighetsinformationen till längst ned i den befintliga listan.

Systemet undersöker var och AccessControlEntry en i följd tills någon av följande händelser inträffar:

• En nekad AccessControlEntry åtkomst nekar uttryckligen någon av de begärda åtkomsträttigheterna till en av de förvaltare som anges i trådens åtkomsttoken.

• Ett eller flera åtkomst tillåtna AccessControlEntry objekt för förvaltare som anges i trådens åtkomsttoken beviljar uttryckligen alla begärda åtkomsträttigheter.

• Alla AccessControlEntry objekt har kontrollerats och det finns fortfarande minst en begärd åtkomsträtt som inte uttryckligen har tillåtits, och i så fall nekas åtkomst implicit.

Rättigheterna till en kö, som anges i parametern rights , kan vara valfri kombination av följande:

• Fullständig kontroll

• Ta bort meddelande

• Ta emot meddelande

• Granska meddelande

• Ta emot journalmeddelande

• Hämta köegenskaper

• Ange köegenskaper

• Hämta behörigheter

• Ange behörigheter

• Ta köägarskap

• Skriv meddelande

Uppräkningen MessageQueueAccessRights representerar en uppsättning bitflaggor som du kan kombinera med bitvis operatorn ELLER för att skapa parametern rights .

Med den här överbelastningen kan du bara bevilja behörigheter. du kan inte återkalla eller neka dem. Du måste använda en annan överlagring för att uttryckligen bevilja någon AccessControlEntryType annan än Allow.

I följande tabell visas om den här metoden är tillgänglig i olika arbetsgruppslägen.

Se även

• ResetPermissions()
• Trustee
• MessageQueueAccessRights

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)

Parametrar

Undantag

Exempel

I följande kodexempel visas användningen av 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);

Kommentarer

Använd den här överlagringen för att bevilja, neka eller återkalla angivna rättigheter för en enskild användare. Användaren kan vara valfri giltig förvaltare, vilket inkluderar enskilda användare, grupper av användare eller en dator. Om användaren är en individ använder du formatet DOMAIN\user för parametern.user Du kan ange "." för parametern user för att ange den lokala datorn.

De behörigheter som du tilldelar genom SetPermissions att lägga till rättigheter till den befintliga listan. Som standard har skaparen av en offentlig eller privat kö fullständig kontroll och domängruppen Alla har behörighet att hämta köegenskaper, hämta behörigheter och skriva till kön. När du anropar SetPermissionsläggs användar- och behörighetsinformationen till längst ned i den befintliga listan.

Systemet undersöker var och AccessControlEntry en i följd tills någon av följande händelser inträffar:

• En nekad AccessControlEntry åtkomst nekar uttryckligen någon av de begärda åtkomsträttigheterna till en av de förvaltare som anges i trådens åtkomsttoken.

• Ett eller flera åtkomst tillåtna AccessControlEntry objekt för förvaltare som anges i trådens åtkomsttoken beviljar uttryckligen alla begärda åtkomsträttigheter.

• Alla AccessControlEntry objekt har kontrollerats och det finns fortfarande minst en begärd åtkomsträtt som inte uttryckligen har tillåtits, och i så fall nekas åtkomst implicit.

Rättigheterna till en kö, som anges i parametern rights , kan vara valfri kombination av följande:

• Fullständig kontroll

• Ta bort meddelande

• Ta emot meddelande

• Granska meddelande

• Ta emot journalmeddelande

• Hämta köegenskaper

• Ange köegenskaper

• Hämta behörigheter

• Ange behörigheter

• Ta köägarskap

• Skriv meddelande

Uppräkningen MessageQueueAccessRights representerar en uppsättning bitflaggor som du kan kombinera med bitvis operatorn ELLER för att skapa parametern rights .

I följande tabell visas om den här metoden är tillgänglig i olika arbetsgruppslägen.

Se även

• ResetPermissions()
• Trustee
• MessageQueueAccessRights
• AccessControlEntry