MessageQueue.SetPermissions Yöntem
Tanım
Önemli
Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.
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
\user
biç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
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
\user
biç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.
Allow
dışı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 |