MessageQueue.SetPermissions Yöntem

Tanım

Geçerli kümeye izin ekler. Bu, kuyruktaki kuyruk özelliklerine ve iletilerine erişim haklarına sahip olan kişileri denetler.

Aşırı Yüklemeler

SetPermissions(AccessControlList)

Erişim denetimi listesinin içeriğine göre kuyruğa erişim hakları atar.

SetPermissions(MessageQueueAccessControlEntry)

Erişim denetimi girdisinin içeriğine göre kuyruğa erişim hakları atar.

SetPermissions(String, MessageQueueAccessRights)

Bir bilgisayara, gruba veya kullanıcıya belirtilen erişim haklarını verir.

SetPermissions(String, MessageQueueAccessRights, AccessControlEntryType)

Bir bilgisayara, gruba veya kullanıcıya belirtilen erişim denetim türüyle (izin ver, reddet, iptal et veya ayarla) belirtilen erişim haklarını verir.

SetPermissions(AccessControlList)

Erişim denetimi listesinin içeriğine göre kuyruğa erişim hakları atar.

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)

Parametreler

dacl
AccessControlList

Güvenenleri ve verilmesi gereken izinleri belirten bir veya daha fazla erişim denetimi girdisi içeren bir AccessControlList.

Özel durumlar

Message Queuing yöntemine erişilirken bir hata oluştu.

Örnekler

Aşağıdaki kod örneği, SetPermissions(AccessControlList)kullanımını gösterir.


// 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);

Açıklamalar

Güvenen ve izin bilgilerini belirtmek üzere bir erişim denetimi girdileri koleksiyonu kullanarak hakları vermek, reddetmek veya iptal etmek için bu aşırı yüklemeyi kullanın. Bu, örneğin, aynı anda birden çok kullanıcıya izin vermek için kullanılır.

ace parametresini oluştururken belirttiğiniz güvenen kişi tek bir kullanıcı, kullanıcı grubu veya bilgisayar olabilir. Mütevelli bir kişiyse, DOMAIN\userbiçimini kullanın. Yerel bilgisayarı göstermek için güvene "." belirtebilirsiniz.

SetPermissions aracılığıyla atadığınız izinler var olan listeye haklar ekler. Varsayılan olarak, ortak veya özel kuyruğu oluşturan tam denetime sahiptir ve Herkes etki alanı grubunun kuyruk özelliklerini alma, izin alma ve kuyruğa yazma izni vardır. SetPermissionsçağırdığınızda, kullanıcı ve izin bilgileri var olan listenin en altına eklenir.

Sistem, aşağıdaki olaylardan biri gerçekleşene kadar her AccessControlEntry sırayla inceler:

  • Erişim reddedildi AccessControlEntry, iş parçacığının erişim belirtecinde listelenen güvenenlerden birine yönelik istenen erişim haklarından herhangi birini açıkça reddeder.

  • İş parçacığının erişim belirtecinde listelenen güvenenler için erişim izni verilen bir veya daha fazla AccessControlEntry öğesi, istenen tüm erişim haklarını açıkça verir.

  • Tüm AccessControlEntry öğeler denetlendi ve hala açıkça izin verilmeyen en az bir istenen erişim hakkı var, bu durumda erişim örtük olarak reddedilir.

dacl parametresini oluşturduğunuzda, AccessControlList koleksiyonunuza AccessControlEntry örnekleri eklersiniz. Her erişim denetimi girdisini oluştururken genel veya standart erişim hakları belirtebilirsiniz. Bir kuyruğun hakları aşağıdakilerin herhangi bir bileşimi olabilir:

  • Silmek

  • Güvenlik Okuma

  • Yazma Güvenliği

  • Senkronize etmek

  • Sahibi Değiştir

  • Okumak

  • Yazmak

  • Yürütmek

  • Gerekli

  • Tüm

  • Hiç kimse

Bu haklar, OR bit düzeyinde işlecini kullanarak birleştirebileceğiniz bit bayrakları kümesidir.

  • Tam Denetim

  • İletiyi Sil

  • İleti Al

  • İletiye Göz Atma

  • Günlük İletisi Al

  • Kuyruk Özelliklerini Alma

  • Kuyruk Özelliklerini Ayarla

  • İzinleri Alma

  • İzinleri Ayarla

  • Kuyruk Sahipliğini Al

  • İleti Yaz

Aşağıdaki tabloda, bu yöntemin çeşitli Çalışma Grubu modlarında kullanılabilir olup olmadığı gösterilmektedir.

Çalışma grubu modu Mevcut
Yerel bilgisayar Evet
Yerel bilgisayar ve doğrudan biçim adı Evet
Uzak bilgisayar Hayır
Uzak bilgisayar ve doğrudan biçim adı Hayır

Ayrıca bkz.

Şunlara uygulanır

SetPermissions(MessageQueueAccessControlEntry)

Erişim denetimi girdisinin içeriğine göre kuyruğa erişim hakları atar.

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)

Parametreler

ace
MessageQueueAccessControlEntry

Kullanıcı, erişim türü ve izin türü belirten bir MessageQueueAccessControlEntry.

Özel durumlar

Message Queuing yöntemine erişilirken bir hata oluştu.

Örnekler

Aşağıdaki kod örneği, SetPermissions(MessageQueueAccessControlEntry)kullanımını gösterir.


// 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);

Açıklamalar

Güvenen ve hak bilgilerini belirtmek üzere bir erişim denetimi girişi kullanarak hakları vermek, reddetmek veya iptal etmek için bu aşırı yüklemeyi kullanın.

ace parametresini oluştururken belirttiğiniz güvenen kişi tek bir kullanıcı, kullanıcı grubu veya bilgisayar olabilir. Mütevelli bir kişiyse, DOMAIN\userbiçimini kullanın. Yerel bilgisayarı göstermek için güvene "." belirtebilirsiniz.

SetPermissions aracılığıyla atadığınız izinler var olan listeye haklar ekler. Varsayılan olarak, ortak veya özel kuyruğu oluşturan tam denetime sahiptir ve Herkes etki alanı grubunun kuyruk özelliklerini alma, izin alma ve kuyruğa yazma izni vardır. SetPermissionsçağırdığınızda, kullanıcı ve izin bilgileri var olan listenin en altına eklenir.

Sistem, aşağıdaki olaylardan biri gerçekleşene kadar her AccessControlEntry sırayla inceler:

  • Erişim reddedildi AccessControlEntry, iş parçacığının erişim belirtecinde listelenen güvenenlerden birine yönelik istenen erişim haklarından herhangi birini açıkça reddeder.

  • İş parçacığının erişim belirtecinde listelenen güvenenler için erişim izni verilen bir veya daha fazla AccessControlEntry öğesi, istenen tüm erişim haklarını açıkça verir.

  • Tüm AccessControlEntry öğeler denetlendi ve hala açıkça izin verilmeyen en az bir istenen erişim hakkı var, bu durumda erişim örtük olarak reddedilir.

MessageQueueAccessControlEntryoluştururken rights parametresinde belirttiğiniz bir kuyruğun hakları aşağıdakilerin herhangi bir bileşimi olabilir:

  • Tam Denetim

  • İletiyi Sil

  • İleti Al

  • İletiye Göz Atma

  • Günlük İletisi Al

  • Kuyruk Özelliklerini Alma

  • Kuyruk Özelliklerini Ayarla

  • İzinleri Alma

  • İzinleri Ayarla

  • Kuyruk Sahipliğini Al

  • İleti Yaz

ace parametresinin oluşturucusunda belirttiğiniz rights parametresi, MessageQueueAccessRights numaralandırmasının bayrağıdır. bit düzeyinde işlecini veya rights parametresini oluştururken birleştirebileceğiniz bir bit bayrağı kümesini temsil eder.

Aşağıdaki tabloda, bu yöntemin çeşitli Çalışma Grubu modlarında kullanılabilir olup olmadığı gösterilmektedir.

Çalışma grubu modu Mevcut
Yerel bilgisayar Evet
Yerel bilgisayar ve doğrudan biçim adı Evet
Uzak bilgisayar Hayır
Uzak bilgisayar ve doğrudan biçim adı Hayır

Ayrıca bkz.

Şunlara uygulanır

SetPermissions(String, MessageQueueAccessRights)

Bir bilgisayara, gruba veya kullanıcıya belirtilen erişim haklarını verir.

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)

Parametreler

user
String

Kuyrukta ek haklara sahip olan kişi, grup veya bilgisayar.

rights
MessageQueueAccessRights

Message Queuing'in iletilen user atadiği kuyruğa yönelik hak kümesini gösteren bir MessageQueueAccessRights.

Özel durumlar

user null.

Message Queuing yöntemine erişilirken bir hata oluştu.

Örnekler

Aşağıdaki kod örneği, SetPermissions(String, MessageQueueAccessRights)kullanımını gösterir.


// 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);

Açıklamalar

Belirli bir kullanıcıya belirtilen hakları vermek için bu aşırı yüklemeyi kullanın. Kullanıcı, tek tek kullanıcıları, kullanıcı gruplarını veya bir bilgisayarı içeren herhangi bir geçerli mütevelli olabilir. Kullanıcı bir kişiyse, user parametresi için DOMAIN\user biçimini kullanın. Yerel bilgisayarı göstermek için user parametresi için "." belirtebilirsiniz.

SetPermissions aracılığıyla atadığınız izinler var olan listeye haklar ekler. Varsayılan olarak, ortak veya özel kuyruğu oluşturan tam denetime sahiptir ve Herkes etki alanı grubunun kuyruk özelliklerini alma, izin alma ve kuyruğa yazma izni vardır. SetPermissionsçağırdığınızda, kullanıcı ve izin bilgileri var olan listenin en altına eklenir.

Sistem, aşağıdaki olaylardan biri gerçekleşene kadar her AccessControlEntry sırayla inceler:

  • Erişim reddedildi AccessControlEntry, iş parçacığının erişim belirtecinde listelenen güvenenlerden birine yönelik istenen erişim haklarından herhangi birini açıkça reddeder.

  • İş parçacığının erişim belirtecinde listelenen güvenenler için erişim izni verilen bir veya daha fazla AccessControlEntry öğesi, istenen tüm erişim haklarını açıkça verir.

  • Tüm AccessControlEntry öğeler denetlendi ve hala açıkça izin verilmeyen en az bir istenen erişim hakkı var, bu durumda erişim örtük olarak reddedilir.

rights parametresinde belirtilen bir kuyruğun hakları aşağıdakilerin herhangi bir bileşimi olabilir:

  • Tam Denetim

  • İletiyi Sil

  • İleti Al

  • İletiye Göz Atma

  • Günlük İletisi Al

  • Kuyruk Özelliklerini Alma

  • Kuyruk Özelliklerini Ayarla

  • İzinleri Alma

  • İzinleri Ayarla

  • Kuyruk Sahipliğini Al

  • İleti Yaz

MessageQueueAccessRights numaralandırması, rights parametresini oluşturmak için bit düzeyinde işlecini veya kullanarak birleştirebileceğiniz bir bit bayrakları kümesini temsil eder.

Bu aşırı yüklemeyle yalnızca izinler verilmektedir; bunları iptal edemez veya reddedemezsiniz. Allowdışında herhangi bir AccessControlEntryType açıkça vermek için farklı bir aşırı yükleme kullanmanız gerekir.

Aşağıdaki tabloda, bu yöntemin çeşitli Çalışma Grubu modlarında kullanılabilir olup olmadığı gösterilmektedir.

Çalışma grubu modu Mevcut
Yerel bilgisayar Evet
Yerel bilgisayar ve doğrudan biçim adı Evet
Uzak bilgisayar Hayır
Uzak bilgisayar ve doğrudan biçim adı Hayır

Ayrıca bkz.

Şunlara uygulanır

SetPermissions(String, MessageQueueAccessRights, AccessControlEntryType)

Bir bilgisayara, gruba veya kullanıcıya belirtilen erişim denetim türüyle (izin ver, reddet, iptal et veya ayarla) belirtilen erişim haklarını verir.

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)

Parametreler

user
String

Kuyrukta ek haklara sahip olan kişi, grup veya bilgisayar.

rights
MessageQueueAccessRights

Message Queuing'in iletilen user atadiği kuyruğa yönelik hak kümesini gösteren bir MessageQueueAccessRights.

entryType
AccessControlEntryType

rights parametresi tarafından belirtilen izinlerin verilip verilmeyeceğini, reddedilip reddedilip iptal edilmeyeceğini belirten bir AccessControlEntryType.

Özel durumlar

Message Queuing yöntemine erişilirken bir hata oluştu.

Örnekler

Aşağıdaki kod örneği, SetPermissions(String, MessageQueueAccessRights, AccessControlEntryType)kullanımını gösterir.


// 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);

Açıklamalar

Tek bir kullanıcıya belirtilen hakları vermek, reddetmek veya iptal etmek için bu aşırı yüklemeyi kullanın. Kullanıcı, tek tek kullanıcıları, kullanıcı gruplarını veya bir bilgisayarı içeren herhangi bir geçerli mütevelli olabilir. Kullanıcı bir kişiyse, user parametresi için DOMAIN\user biçimini kullanın. Yerel bilgisayarı göstermek için user parametresi için "." belirtebilirsiniz.

SetPermissions aracılığıyla atadığınız izinler var olan listeye haklar ekler. Varsayılan olarak, ortak veya özel kuyruğu oluşturan tam denetime sahiptir ve Herkes etki alanı grubunun kuyruk özelliklerini alma, izin alma ve kuyruğa yazma izni vardır. SetPermissionsçağırdığınızda, kullanıcı ve izin bilgileri var olan listenin en altına eklenir.

Sistem, aşağıdaki olaylardan biri gerçekleşene kadar her AccessControlEntry sırayla inceler:

  • Erişim reddedildi AccessControlEntry, iş parçacığının erişim belirtecinde listelenen güvenenlerden birine yönelik istenen erişim haklarından herhangi birini açıkça reddeder.

  • İş parçacığının erişim belirtecinde listelenen güvenenler için erişim izni verilen bir veya daha fazla AccessControlEntry öğesi, istenen tüm erişim haklarını açıkça verir.

  • Tüm AccessControlEntry öğeler denetlendi ve hala açıkça izin verilmeyen en az bir istenen erişim hakkı var, bu durumda erişim örtük olarak reddedilir.

rights parametresinde belirtilen bir kuyruğun hakları aşağıdakilerin herhangi bir bileşimi olabilir:

  • Tam Denetim

  • İletiyi Sil

  • İleti Al

  • İletiye Göz Atma

  • Günlük İletisi Al

  • Kuyruk Özelliklerini Alma

  • Kuyruk Özelliklerini Ayarla

  • İzinleri Alma

  • İzinleri Ayarla

  • Kuyruk Sahipliğini Al

  • İleti Yaz

MessageQueueAccessRights numaralandırması, rights parametresini oluşturmak için bit düzeyinde işlecini veya kullanarak birleştirebileceğiniz bir bit bayrakları kümesini temsil eder.

Aşağıdaki tabloda, bu yöntemin çeşitli Çalışma Grubu modlarında kullanılabilir olup olmadığı gösterilmektedir.

Çalışma grubu modu Mevcut
Yerel bilgisayar Evet
Yerel bilgisayar ve doğrudan biçim adı Evet
Uzak bilgisayar Hayır
Uzak bilgisayar ve doğrudan biçim adı Hayır

Ayrıca bkz.

Şunlara uygulanır