MessageQueue.GetMachineId(String) Metod

Definition

Namnområde:
System.Messaging
Sammansättning:
System.Messaging.dll

Hämtar identifieraren för den dator där kön som refereras av detta MessageQueue finns.

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

Parametrar

machineName
String

Namnet på datorn som innehåller kön, utan de två föregående omvänt snedstrecken (\\).

Returer

Guid

En Guid som representerar en unik identifierare för den dator där kön finns.

Undantag

MessageQueueException

Det gick inte att hämta datoridentifieraren, möjligen på grund av att katalogtjänsten inte är tillgänglig. om du till exempel arbetar offline.

-eller-

Ett fel uppstod vid åtkomst till en Message Queuing-metod.

Exempel

I följande kodexempel anropas 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));

Kommentarer

Du kan använda en dators identifierare i två syften, bland annat för att läsa datorjournalen och ange säkerhetscertifikat. Du kan dock inte anropa GetMachineId(String) en fjärrdator när du arbetar offline eftersom programmet måste ha åtkomst till katalogtjänsten på domänkontrollanten.

Datoridentifieraren (eller datoridentifieraren) är en Guid som Message Queuing skapar när en dator läggs till i företaget. Message Queuing kombinerar datoridentifieraren med nyckelorden Machine och Journal för att skapa datorjournalens formatnamn, som har syntaxen Machine=<computeridentifier>;Journal. Datorjournalen, som även kallas journalkön, är en systemkö som lagrar kopior av programgenererade meddelanden när UseJournalQueue egenskapen är true.

Den här syntaxen för journalen är endast giltig när du skapar formatnamnet för kön. Sökvägsnamnsyntaxen är MachineName\Journal$.

I följande tabell visas om den här metoden är tillgänglig i olika arbetsgruppslägen.

Arbetsgruppsläge Tillgängligt
Lokal dator No
Namn på lokal dator och direktformat No
Fjärrdator No
Namn på fjärrdator och direktformat No

Gäller för

Se även