MessageQueue.GetMachineId(String) Yöntem

Tanım

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 Kuyruğun bulunduğu bilgisayar için benzersiz tanımlayıcıyı temsil eden bir.

Özel durumlar

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

Şunlara uygulanır

Ayrıca bkz.