MessageQueue.GetMachineId(String) Methode

Referenz

Definition

Namespace:: System.Messaging

Assembly:: System.Messaging.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Ruft den Computerbezeichner ab, auf dem sich die Warteschlange befindet, auf die diese MessageQueue verweist.

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

Parameter

machineName: String

Der Name des Computers, der die Warteschlange enthält, ohne die beiden vorherigen umgekehrten Schrägstriche (\\).

Gibt zurück

Guid

Eine Guid, die einen eindeutigen Bezeichner für den Computer darstellt, auf dem sich die Warteschlange befindet.

Ausnahmen

MessageQueueException

Der Computerbezeichner konnte nicht abgerufen werden. Möglicherweise ist der Verzeichnisdienst nicht verfügbar (z. B. während der Ausführung im Offlinebetrieb).

- oder -

Fehler beim Zugriff auf eine Message Queuing-Methode.

Beispiele

Im folgenden Codebeispiel wird GetMachineId(String) aufgerufen.

// 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));

Hinweise

Sie können den Bezeichner eines Computers für zwei Zwecke verwenden, unter anderem zum Lesen des Computerjournals und zum Festlegen von Sicherheitszertifikaten. Sie können jedoch keinen Remotecomputer aufrufen GetMachineId(String) , wenn Sie offline arbeiten, da die Anwendung Zugriff auf den Verzeichnisdienst auf dem Domänencontroller haben muss.

Der Computerbezeichner (oder Computerbezeichner) ist ein Guid , den Message Queuing erstellt, wenn dem Unternehmen ein Computer hinzugefügt wird. Message Queuing kombiniert den Computerbezeichner mit den Machine Schlüsselwörtern und Journal , um den Formatnamen des Computerjournals zu erstellen, der die Syntax Machine=<computeridentifier>;Journalaufweist. Das Computerjournal, das auch als Journalwarteschlange bezeichnet wird, ist eine Systemwarteschlange, die Kopien von von der Anwendung generierten Nachrichten speichert, wenn die UseJournalQueue -Eigenschaft lautet true.

Diese Syntax für das Journal ist nur gültig, wenn der Formatname für die Warteschlange erstellt wird. Die Pfadnamensyntax ist MachineName\Journal$.

Die folgende Tabelle zeigt, ob diese Methode in verschiedenen Arbeitsgruppenmodi verfügbar ist.

Arbeitsgruppenmodus	Verfügbar
Lokalem Computer	Nein
Name des lokalen Computers und des direkten Formats	Nein
Remotecomputer	Nein
Name des Remotecomputers und des direkten Formats	Nein

Gilt für: