MessageQueue.GetMachineId(String) Metode

Definisi

Ruang nama:

System.Messaging

Rakitan:

System.Messaging.dll

Mendapatkan pengidentifikasi komputer tempat antrean yang direferensikan oleh ini MessageQueue berada.

public:
 static Guid GetMachineId(System::String ^ machineName);

public static Guid GetMachineId (string machineName);

static member GetMachineId : string -> Guid

Public Shared Function GetMachineId (machineName As String) As Guid

Parameter

machineName

String

Nama komputer yang berisi antrean, tanpa dua garis miring terbalik sebelumnya (\\).

Mengembalikan

Guid

Guid yang mewakili pengidentifikasi unik untuk komputer tempat antrean berada.

Pengecualian

MessageQueueException

Pengidentifikasi komputer tidak dapat diambil, mungkin karena layanan direktori tidak tersedia; misalnya, jika Anda bekerja offline.

-atau-

Terjadi kesalahan saat mengakses metode Antrean Pesan.

Contoh

Contoh kode berikut memanggil GetMachineId(String).

// Get the name of the computer that contains the queue.
string machineName = queue.MachineName;

// Display the return value of the MessageQueue.GetMachineId method.
Console.WriteLine("MessageQueue.GetMachineId(): {0}",
    MessageQueue.GetMachineId(machineName));

Keterangan

Anda dapat menggunakan pengidentifikasi komputer untuk dua tujuan, antara lain: membaca jurnal komputer dan mengatur sertifikat keamanan. Namun, Anda tidak dapat memanggil GetMachineId(String) komputer jarak jauh saat bekerja offline karena aplikasi harus memiliki akses ke layanan direktori pada pengendali domain.

Pengidentifikasi komputer (atau pengidentifikasi mesin) adalah Guid pengidentifikasi Pesan yang dibuat saat komputer ditambahkan ke perusahaan. Antrean Pesan menggabungkan pengidentifikasi komputer dengan Machine kata kunci dan Journal untuk membuat nama format jurnal mesin, yang memiliki sintaks Machine=<computeridentifier>;Journal. Jurnal mesin, yang juga dikenal sebagai antrean jurnal, adalah antrean sistem yang menyimpan salinan pesan yang dihasilkan aplikasi ketika UseJournalQueue properti adalah true.

Sintaksis untuk jurnal ini hanya valid saat membuat nama format untuk antrean. Sintaks nama jalur adalah MachineName\Journal$.

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

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

Lihat juga

• MachineName
• UseJournalQueue