MessageQueue.GetMachineId(String) Metoda

Definicja

Przestrzeń nazw:

System.Messaging

Zestaw:

System.Messaging.dll

Pobiera identyfikator komputera, na którym znajduje się kolejka, do której odwołuje się ta MessageQueue kolejka.

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

Nazwa komputera, który zawiera kolejkę, bez dwóch poprzednich ukośników odwrotnych (\\).

Zwraca

Guid

Element Guid reprezentujący unikatowy identyfikator komputera, na którym znajduje się kolejka.

Wyjątki

MessageQueueException

Nie można pobrać identyfikatora komputera, prawdopodobnie dlatego, że usługa katalogowa jest niedostępna; na przykład jeśli pracujesz w trybie offline.

-lub-

Wystąpił błąd podczas uzyskiwania dostępu do metody kolejkowania komunikatów.

Przykłady

Poniższy przykład kodu wywołuje metodę 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));

Uwagi

Można użyć identyfikatora komputera do dwóch celów, między innymi: do odczytywania dziennika komputerowego i ustawiania certyfikatów zabezpieczeń. Nie można jednak wywołać GetMachineId(String) komputera zdalnego podczas pracy w trybie offline, ponieważ aplikacja musi mieć dostęp do usługi katalogowej na kontrolerze domeny.

Identyfikator komputera (lub identyfikator komputera) jest Guid tworzony przez kolejkowanie komunikatów po dodaniu komputera do przedsiębiorstwa. Kolejkowanie komunikatów łączy identyfikator komputera ze słowami kluczowymi Machine i Journal w celu utworzenia nazwy formatu dziennika maszynowego, która ma składnię Machine=<computeridentifier>;Journal. Dziennik maszynowy, znany również jako kolejka dziennika, jest kolejką systemową, która przechowuje kopie komunikatów generowanych przez aplikację, gdy UseJournalQueue właściwość to true.

Ta składnia dziennika jest prawidłowa tylko podczas konstruowania nazwy formatu kolejki. Składnia nazwy ścieżki to MachineName\Journal$.

W poniższej tabeli przedstawiono, czy ta metoda jest dostępna w różnych trybach grupy roboczej.

Tryb grupy roboczej	Dostępne
Komputer lokalny	Nie
Komputer lokalny i nazwa formatu bezpośredniego	Nie
Komputer zdalny	Nie
Nazwa komputera zdalnego i formatu bezpośredniego	Nie

Zobacz też

• MachineName
• UseJournalQueue