MessageQueue.GetMachineId(String) Metoda

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 odkazovaná tímto MessageQueue objektem.

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

Jedná se Guid o jedinečný identifikátor počítače, na kterém se nachází fronta.

Výjimky

MessageQueueException

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

nebo

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

Příklady

Následující příklad kódu volá 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 pro dva účely, mimo jiné: ke čtení deníku počítače a k nastavení certifikátů zabezpečení. Při práci offline ale nemůžete 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 podniku. Služba Řízení front zpráv kombinuje identifikátor počítače s Machine klíčovými slovy a Journal vytvoří název formátu deníku počítače, který má syntaxi Machine=<computeridentifier>;Journal. Deník počítače, který se také označuje jako fronta deníku, je systémová fronta, která ukládá kopie zpráv generovaných aplikací, pokud 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č	Ne
Název místního počítače a přímého formátu	Ne
Vzdálený počítač	Ne
Název vzdáleného počítače a přímého formátu	Ne

Viz také

• MachineName
• UseJournalQueue