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ı; önce gelen 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ıları 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 günlüğünü okumak ve güvenlik sertifikalarını ayarlamak için, bilgisayarın tanımlayıcısını iki amaçla kullanabilirsiniz. Ancak, uygulamanın etki alanı denetleyicisindeki dizin hizmetine erişimi olması gerektiğinden, çevrimdışı çalışırken uzak bilgisayarı çağıramazsınız GetMachineId(String) .

Bilgisayar tanımlayıcısı (veya makine tanımlayıcısı), kuruluşa bir Guid bilgisayar eklendiğinde Message Queuing tarafından oluşturulan bir tanımlayıcıdır. 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	Kullanılabilir
Yerel bilgisayar	No
Yerel bilgisayar ve doğrudan biçim adı	No
Uzak bilgisayar	No
Uzak bilgisayar ve doğrudan biçim adı	No

Ayrıca bkz.

• MachineName
• UseJournalQueue