MessageQueue.SetPermissions Metode

Definisi

Ruang nama:: System.Messaging

Rakitan:: System.Messaging.dll

Penting

Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

Menambahkan izin ke set saat ini. Ini mengontrol siapa yang memiliki hak akses ke properti antrean dan pesan dalam antrean.

Overload

Nama	Deskripsi
SetPermissions(AccessControlList)	Menetapkan hak akses ke antrean berdasarkan konten daftar kontrol akses.
SetPermissions(MessageQueueAccessControlEntry)	Menetapkan hak akses ke antrean berdasarkan konten entri kontrol akses.
SetPermissions(String, MessageQueueAccessRights)	Memberi komputer, grup, atau pengguna hak akses yang ditentukan.
SetPermissions(String, MessageQueueAccessRights, AccessControlEntryType)	Memberi komputer, grup, atau pengguna hak akses yang ditentukan, dengan jenis kontrol akses yang ditentukan (izinkan, tolak, cabut, atau atur).

SetPermissions(AccessControlList)

Menetapkan hak akses ke antrean berdasarkan konten daftar kontrol akses.

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)

Parameter

dacl: AccessControlList

Yang AccessControlList berisi satu atau beberapa entri kontrol akses yang menentukan wali dan izin yang akan diberikan.

Pengecualian

MessageQueueException

Terjadi kesalahan saat mengakses metode Antrean Pesan.

Contoh

Contoh kode berikut menunjukkan penggunaan 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);

Keterangan

Gunakan kelebihan beban ini untuk memberikan, menolak, atau mencabut hak dengan menggunakan kumpulan entri kontrol akses untuk menentukan informasi kepercayaan dan izin. Ini digunakan, misalnya, untuk memberikan izin kepada beberapa pengguna secara bersamaan.

Wali yang Anda tentukan saat membuat ace parameter dapat menjadi pengguna individual, sekelompok pengguna, atau komputer. Jika wali adalah individu, gunakan format DOMAIN\user. Anda dapat menentukan "." bagi wali untuk menunjukkan komputer lokal.

Izin yang Anda tetapkan melalui SetPermissions tambahkan hak ke daftar yang sudah ada. Secara default, pembuat antrean publik atau privat memiliki kontrol penuh, dan grup domain Setiap orang memiliki izin untuk mendapatkan properti antrean, mendapatkan izin, dan menulis ke antrean. Saat Anda memanggil SetPermissions, informasi pengguna dan izin ditambahkan ke bagian bawah daftar yang sudah ada.

Sistem memeriksa masing-masing AccessControlEntry secara berurutan sampai salah satu peristiwa berikut terjadi:

Akses yang ditolak AccessControlEntry secara eksplisit menolak salah satu hak akses yang diminta ke salah satu wali yang tercantum dalam token akses utas.
Satu atau beberapa item yang diizinkan AccessControlEntry akses untuk wali yang tercantum dalam token akses utas secara eksplisit memberikan semua hak akses yang diminta.
Semua AccessControlEntry item telah diperiksa dan masih ada setidaknya satu hak akses yang diminta yang belum diizinkan secara eksplisit, dalam hal ini, akses secara implisit ditolak.

Saat membuat dacl parameter, Anda menambahkan AccessControlEntry instans ke koleksi Anda AccessControlList . Saat membuat setiap entri kontrol akses, Anda dapat menentukan hak akses generik atau standar. Hak atas antrean dapat berupa kombinasi apa pun dari yang berikut:

Hapus
Keamanan Baca
Keamanan Tulis
Synchronize
Ubah Pemilik
Read
Write
Menjalankan
Required
All
Tidak

Hak-hak ini adalah sekumpulan bendera bit yang dapat Anda gabungkan menggunakan operator BITWISE.

Kontrol Penuh
Hapus Pesan
Terima Pesan
Mengintip Pesan
Menerima Pesan Jurnal
Dapatkan Properti Antrean
Mengatur Properti Antrean
Dapatkan Izin
Atur Izin
Ambil Kepemilikan Antrean
Tulis Pesan

Tabel berikut menunjukkan apakah metode ini tersedia dalam berbagai mode Grup Kerja.

Mode grup kerja	Available
Komputer lokal	Ya
Komputer lokal dan nama format langsung	Ya
Komputer jarak jauh	Tidak
Komputer jarak jauh dan nama format langsung	Tidak

Lihat juga

Berlaku untuk

SetPermissions(MessageQueueAccessControlEntry)

Menetapkan hak akses ke antrean berdasarkan konten entri kontrol akses.

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)

Parameter

ace: MessageQueueAccessControlEntry

MessageQueueAccessControlEntry Yang menentukan pengguna, jenis akses, dan jenis izin.

Pengecualian

MessageQueueException

Terjadi kesalahan saat mengakses metode Antrean Pesan.

Contoh

Contoh kode berikut menunjukkan penggunaan 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);

Keterangan

Gunakan kelebihan beban ini untuk memberikan, menolak, atau mencabut hak dengan menggunakan entri kontrol akses untuk menentukan informasi kepercayaan dan hak.

Sistem memeriksa masing-masing AccessControlEntry secara berurutan sampai salah satu peristiwa berikut terjadi:

Akses yang ditolak AccessControlEntry secara eksplisit menolak salah satu hak akses yang diminta ke salah satu wali yang tercantum dalam token akses utas.
Satu atau beberapa item yang diizinkan AccessControlEntry akses untuk wali yang tercantum dalam token akses utas secara eksplisit memberikan semua hak akses yang diminta.
Semua AccessControlEntry item telah diperiksa dan masih ada setidaknya satu hak akses yang diminta yang belum diizinkan secara eksplisit, dalam hal ini, akses secara implisit ditolak.

Hak untuk antrean, yang Anda tentukan dalam rights parameter saat Anda membuat MessageQueueAccessControlEntry, dapat berupa kombinasi apa pun dari yang berikut:

Kontrol Penuh
Hapus Pesan
Terima Pesan
Mengintip Pesan
Menerima Pesan Jurnal
Dapatkan Properti Antrean
Mengatur Properti Antrean
Dapatkan Izin
Atur Izin
Ambil Kepemilikan Antrean
Tulis Pesan

Parameter rights yang Anda tentukan di konstruktor untuk ace parameter adalah bendera MessageQueueAccessRights enumerasi. Ini mewakili sekumpulan bendera bit yang dapat Anda gabungkan menggunakan operator bitwise ATAU saat Anda membangun rights parameter.

Tabel berikut menunjukkan apakah metode ini tersedia dalam berbagai mode Grup Kerja.

Mode grup kerja	Available
Komputer lokal	Ya
Komputer lokal dan nama format langsung	Ya
Komputer jarak jauh	Tidak
Komputer jarak jauh dan nama format langsung	Tidak

Lihat juga

Berlaku untuk

SetPermissions(String, MessageQueueAccessRights)

Memberi komputer, grup, atau pengguna hak akses yang ditentukan.

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)

Parameter

user: String

Individu, grup, atau komputer yang mendapatkan hak tambahan untuk antrean.

rights: MessageQueueAccessRights

MessageQueueAccessRights yang menunjukkan sekumpulan hak untuk antrean yang ditetapkan Antrean Pesan ke yang user diteruskan.

Pengecualian

ArgumentException

user adalah null.

MessageQueueException

Terjadi kesalahan saat mengakses metode Antrean Pesan.

Contoh

Contoh kode berikut menunjukkan penggunaan 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);

Keterangan

Gunakan kelebihan beban ini untuk memberikan hak yang ditentukan kepada pengguna individual. Pengguna dapat menjadi wali yang valid, yang mencakup pengguna individu, grup pengguna, atau komputer. Jika pengguna adalah individu, gunakan format DOMAIN\user untuk user parameter . Anda dapat menentukan "." untuk parameter untuk user menunjukkan komputer lokal.

Sistem memeriksa masing-masing AccessControlEntry secara berurutan sampai salah satu peristiwa berikut terjadi:

Akses yang ditolak AccessControlEntry secara eksplisit menolak salah satu hak akses yang diminta ke salah satu wali yang tercantum dalam token akses utas.
Satu atau beberapa item yang diizinkan AccessControlEntry akses untuk wali yang tercantum dalam token akses utas secara eksplisit memberikan semua hak akses yang diminta.
Semua AccessControlEntry item telah diperiksa dan masih ada setidaknya satu hak akses yang diminta yang belum diizinkan secara eksplisit, dalam hal ini, akses secara implisit ditolak.

Hak untuk antrean, yang ditentukan dalam rights parameter, dapat berupa kombinasi apa pun dari yang berikut ini:

Kontrol Penuh
Hapus Pesan
Terima Pesan
Mengintip Pesan
Menerima Pesan Jurnal
Dapatkan Properti Antrean
Mengatur Properti Antrean
Dapatkan Izin
Atur Izin
Ambil Kepemilikan Antrean
Tulis Pesan

Enumerasi MessageQueueAccessRights mewakili sekumpulan bendera bit yang dapat Anda gabungkan menggunakan operator bitwise ATAU untuk membangun rights parameter.

Dengan kelebihan beban ini, Anda hanya dapat memberikan izin; Anda tidak dapat mencabut atau menolaknya. Anda harus menggunakan kelebihan beban yang berbeda untuk memberikan AccessControlEntryType secara eksplisit selain Allow.

Tabel berikut menunjukkan apakah metode ini tersedia dalam berbagai mode Grup Kerja.

Mode grup kerja	Available
Komputer lokal	Ya
Komputer lokal dan nama format langsung	Ya
Komputer jarak jauh	Tidak
Komputer jarak jauh dan nama format langsung	Tidak

Lihat juga

Berlaku untuk

SetPermissions(String, MessageQueueAccessRights, AccessControlEntryType)

Memberi komputer, grup, atau pengguna hak akses yang ditentukan, dengan jenis kontrol akses yang ditentukan (izinkan, tolak, cabut, atau atur).

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)

Parameter

user: String

Individu, grup, atau komputer yang mendapatkan hak tambahan untuk antrean.

rights: MessageQueueAccessRights

MessageQueueAccessRights yang menunjukkan sekumpulan hak untuk antrean yang ditetapkan Antrean Pesan ke yang user diteruskan.

entryType: AccessControlEntryType

AccessControlEntryType Yang menentukan apakah akan memberikan, menolak, atau mencabut izin yang ditentukan oleh rights parameter.

Pengecualian

MessageQueueException

Terjadi kesalahan saat mengakses metode Antrean Pesan.

Contoh

Contoh kode berikut menunjukkan penggunaan 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);

Keterangan

Gunakan kelebihan beban ini untuk memberikan, menolak, atau mencabut hak yang ditentukan untuk pengguna individual. Pengguna dapat menjadi wali yang valid, yang mencakup pengguna individu, grup pengguna, atau komputer. Jika pengguna adalah individu, gunakan format DOMAIN\user untuk user parameter . Anda dapat menentukan "." untuk parameter untuk user menunjukkan komputer lokal.

Sistem memeriksa masing-masing AccessControlEntry secara berurutan sampai salah satu peristiwa berikut terjadi:

Akses yang ditolak AccessControlEntry secara eksplisit menolak salah satu hak akses yang diminta ke salah satu wali yang tercantum dalam token akses utas.
Satu atau beberapa item yang diizinkan AccessControlEntry akses untuk wali yang tercantum dalam token akses utas secara eksplisit memberikan semua hak akses yang diminta.
Semua AccessControlEntry item telah diperiksa dan masih ada setidaknya satu hak akses yang diminta yang belum diizinkan secara eksplisit, dalam hal ini, akses secara implisit ditolak.

Hak untuk antrean, yang ditentukan dalam rights parameter, dapat berupa kombinasi apa pun dari yang berikut ini:

Kontrol Penuh
Hapus Pesan
Terima Pesan
Mengintip Pesan
Menerima Pesan Jurnal
Dapatkan Properti Antrean
Mengatur Properti Antrean
Dapatkan Izin
Atur Izin
Ambil Kepemilikan Antrean
Tulis Pesan

Enumerasi MessageQueueAccessRights mewakili sekumpulan bendera bit yang dapat Anda gabungkan menggunakan operator bitwise ATAU untuk membangun rights parameter.

Tabel berikut menunjukkan apakah metode ini tersedia dalam berbagai mode Grup Kerja.

Mode grup kerja	Available
Komputer lokal	Ya
Komputer lokal dan nama format langsung	Ya
Komputer jarak jauh	Tidak
Komputer jarak jauh dan nama format langsung	Tidak

Lihat juga

Berlaku untuk

Saran dan Komentar

Apakah halaman ini membantu?