MessageQueue.GetMachineId(String) Metoda

  • Reference

Definice

Obor názvů:
System.Messaging
Sestavení:
System.Messaging.dll

Získá identifikátor počítače, na kterém je umístěna fronta, na kterou odkazuje.MessageQueue

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

Parametry

machineName
String

Název počítače, který obsahuje frontu bez dvou předchozích zpětných lomítek (\\).

Návraty

Guid

A Guid , který představuje jedinečný identifikátor pro počítač, na kterém je umístěna fronta.

Výjimky

MessageQueueException

Identifikátor počítače nelze načíst, pravděpodobně proto, že adresářová služba není k dispozici; například pokud pracujete offline.

-nebo-

Při přístupu k metodě služby Řízení front zpráv došlo k chybě.

Příklady

Následující příklad volá kódu 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));

Poznámky

Identifikátor počítače můžete použít mimo jiné ke dvěma účelům: ke čtení deníku počítačů a k nastavení certifikátů zabezpečení. Při práci offline však nelze volat GetMachineId(String) vzdálený počítač, protože aplikace musí mít přístup k adresářové službě na řadiči domény.

Identifikátor počítače (nebo identifikátor počítače) je Guid identifikátor, který služba Řízení front zpráv vytvoří při přidání počítače do organizace. Služba Řízení front zpráv zkombinuje identifikátor počítače s Machine klíčovými slovy a Journal a vytvoří název formátu deníku počítačů, který má syntaxi Machine=<computeridentifier>;Journal. Deník počítačů, který se také označuje jako fronta deníku, je systémová fronta, která ukládá kopie zpráv generovaných aplikací, když UseJournalQueue je truevlastnost .

Tato syntaxe deníku je platná pouze při vytváření názvu formátu pro frontu. Syntaxe názvu cesty je MachineName\Journal$.

Následující tabulka ukazuje, zda je tato metoda k dispozici v různých režimech pracovní skupiny.

Režim pracovní skupiny K dispozici.
Místní počítač No
Název místního počítače a přímého formátu No
Vzdálený počítač No
Název vzdáleného počítače a přímého formátu No

Platí pro

Viz také