MessageQueue.GetMachineId(String) Yöntem

Tanım

Ad Alanı:

System.Messaging

Bütünleştirilmiş Kod:

System.Messaging.dll

Bu MessageQueue tarafından başvurulan kuyruğun bulunduğu bilgisayarın tanımlayıcısını alır.

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

Parametreler

machineName

String

Kuyruğu içeren bilgisayarın adı; önceki iki ters eğik çizgi (\\).

Döndürülenler

Guid

Guid Kuyruğun bulunduğu bilgisayar için benzersiz tanımlayıcıyı temsil eden bir.

Özel durumlar

MessageQueueException

Dizin hizmeti kullanılamadığından bilgisayar tanımlayıcısı alınamadı; örneğin, çevrimdışı çalışıyorsanız.

-veya-

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

Örnekler

Aşağıdaki kod örneği çağrısı yapar 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));

Açıklamalar

Bilgisayarın tanımlayıcısını iki amaçla kullanabilirsiniz: bilgisayar günlüğünü okumak ve güvenlik sertifikaları ayarlamak için. Ancak, uygulamanın etki alanı denetleyicisindeki dizin hizmetine erişimi olması gerektiğinden çevrimdışı çalışırken uzak bilgisayarı arayamazsınız GetMachineId(String) .

Bilgisayar tanımlayıcısı (veya makine tanımlayıcısı), bir bilgisayar kuruluşa eklendiğinde Message Queuing tarafından oluşturulan bir tanımlayıcıdır Guid . Message Queuing, söz dizimine Machine=<computeridentifier>;Journalsahip makine günlüğünün Machine biçim adını oluşturmak için bilgisayar tanımlayıcısını ve Journal anahtar sözcükleriyle birleştirir. Günlük kuyruğu olarak da bilinen makine günlüğü, özelliği olduğunda UseJournalQueue uygulama tarafından oluşturulan iletilerin kopyalarını depolayan bir sistem kuyruğudur true.

Günlüğün bu söz dizimi yalnızca kuyruk için biçim adı oluşturulurken geçerlidir. Yol adı söz dizimi şeklindedir MachineName\Journal$.

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	Hayır
Yerel bilgisayar ve doğrudan biçim adı	Hayır
Uzak bilgisayar	Hayır
Uzak bilgisayar ve doğrudan biçim adı	Hayır

Ayrıca bkz.

• MachineName
• UseJournalQueue