MessageQueue.SetPermissions Metode

Definisi

Ruang nama:

System.Messaging

Rakitan:

System.Messaging.dll

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

Overload

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 hak akses yang ditentukan kepada pengguna.
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

AccessControlList yang berisi satu atau beberapa entri kontrol akses yang menentukan kepercayaan 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 secara AccessControlEntry berurutan sampai salah satu peristiwa berikut terjadi:

• Akses ditolak AccessControlEntry secara eksplisit menolak salah satu hak akses yang diminta ke salah satu kepercayaan 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 ditolak secara implisit.

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 untuk antrean dapat berupa kombinasi apa pun dari yang berikut:

• Hapus

• Baca Keamanan

• Keamanan Tulis

• Menyinkronkan

• Ubah Pemilik

• Baca

• Tulis

• Jalankan

• Diperlukan

• Semua

• Tidak ada

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

• Kontrol Penuh

• Hapus Pesan

• Terima Pesan

• Mengintip Pesan

• Terima Pesan Journal

• Mendapatkan Properti Antrean

• Mengatur Properti Antrean

• Dapatkan Izin

• Mengatur perizinan

• Ambil Kepemilikan Antrean

• Tulis Pesan

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

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

Lihat juga

• ResetPermissions()
• Trustee
• AccessControlList

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 hak dan wali.

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 secara AccessControlEntry berurutan sampai salah satu peristiwa berikut terjadi:

• Akses ditolak AccessControlEntry secara eksplisit menolak salah satu hak akses yang diminta ke salah satu kepercayaan 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 ditolak secara implisit.

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

• Kontrol Penuh

• Hapus Pesan

• Terima Pesan

• Mengintip Pesan

• Terima Pesan Journal

• Mendapatkan Properti Antrean

• Mengatur Properti Antrean

• Dapatkan Izin

• Mengatur perizinan

• 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	Tersedia
Komputer lokal	Ya
Komputer lokal dan nama format langsung	Ya
Komputer jarak jauh	Tidak
Komputer jarak jauh dan nama format langsung	Tidak

Lihat juga

• ResetPermissions()
• Trustee
• MessageQueueAccessRights
• MessageQueueAccessControlEntry

SetPermissions(String, MessageQueueAccessRights)

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

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 tertentu kepada pengguna individual. Pengguna dapat menjadi wali yang valid, yang mencakup pengguna individual, grup pengguna, atau komputer. Jika pengguna adalah individu, gunakan format DOMAIN\user untuk user parameter . Anda dapat menentukan "." untuk user parameter 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 secara AccessControlEntry berurutan sampai salah satu peristiwa berikut terjadi:

• Akses ditolak AccessControlEntry secara eksplisit menolak salah satu hak akses yang diminta ke salah satu kepercayaan 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 ditolak secara implisit.

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

• Kontrol Penuh

• Hapus Pesan

• Terima Pesan

• Mengintip Pesan

• Terima Pesan Journal

• Mendapatkan Properti Antrean

• Mengatur Properti Antrean

• Dapatkan Izin

• Mengatur perizinan

• 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 secara eksplisit memberikan selain AccessControlEntryTypeAllow.

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

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

Lihat juga

• ResetPermissions()
• Trustee
• MessageQueueAccessRights

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 tertentu untuk pengguna individu. Pengguna dapat menjadi wali yang valid, yang mencakup pengguna individual, grup pengguna, atau komputer. Jika pengguna adalah individu, gunakan format DOMAIN\user untuk user parameter . Anda dapat menentukan "." untuk user parameter 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 secara AccessControlEntry berurutan sampai salah satu peristiwa berikut terjadi:

• Akses ditolak AccessControlEntry secara eksplisit menolak salah satu hak akses yang diminta ke salah satu kepercayaan 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 ditolak secara implisit.

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

• Kontrol Penuh

• Hapus Pesan

• Terima Pesan

• Mengintip Pesan

• Terima Pesan Journal

• Mendapatkan Properti Antrean

• Mengatur Properti Antrean

• Dapatkan Izin

• Mengatur perizinan

• 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	Tersedia
Komputer lokal	Ya
Komputer lokal dan nama format langsung	Ya
Komputer jarak jauh	Tidak
Komputer jarak jauh dan nama format langsung	Tidak

Lihat juga

• ResetPermissions()
• Trustee
• MessageQueueAccessRights
• AccessControlEntry