MessageQueue.GetMachineId(String) Metódus

Definíció

Névtér:

System.Messaging

Szerelvény:

System.Messaging.dll

Lekéri annak a számítógépnek az azonosítóját, amelyen az ezzel MessageQueue hivatkozott üzenetsor található.

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

Paraméterek

machineName

String

Az üzenetsort tartalmazó számítógép neve az előző két fordított perjel (\\) nélkül.

Válaszok

Guid

Egy Guid egyedi azonosító annak a számítógépnek, amelyen az üzenetsor található.

Kivételek

MessageQueueException

A számítógépazonosítót nem sikerült lekérni, valószínűleg azért, mert a címtárszolgáltatás nem érhető el; ha például offline dolgozik.

-vagy-

Hiba történt a Message Queuing metódus elérésekor.

Példák

Az alábbi példakód hivatkozik 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));

Megjegyzések

A számítógép azonosítóját többek között két célra használhatja: a számítógépnapló olvasására és a biztonsági tanúsítványok beállítására. Offline munka közben azonban nem hívhat GetMachineId(String) távoli számítógépet, mert az alkalmazásnak hozzáféréssel kell rendelkeznie a címtárszolgáltatáshoz a tartományvezérlőn.

A számítógép-azonosító (vagy gépazonosító) a Guid Message Queuing által a vállalathoz hozzáadott számítógép létrehozásakor jön létre. A Message Queuing a számítógép azonosítóját és Machine a Journal kulcsszavakat kombinálva hozza létre a gépnapló formátumnevét, amely szintaxissal rendelkezikMachine=<computeridentifier>;Journal. A gépi napló, más néven a naplósor egy rendszersor, amely az alkalmazás által létrehozott üzenetek másolatait tárolja, amikor a UseJournalQueue tulajdonság értéke .true

A napló szintaxisa csak az üzenetsor formátumnevének létrehozásakor érvényes. Az elérési út neve szintaxisa.MachineName\Journal$

Az alábbi táblázat azt mutatja be, hogy ez a módszer elérhető-e különböző munkacsoport-módban.

Munkacsoport mód	Elérhető
Helyi számítógép	No
Helyi számítógép és közvetlen formátum neve	No
Távoli számítógép	No
Távoli számítógép és közvetlen formátum neve	No

Lásd még

• MachineName
• UseJournalQueue