Freigeben über


MessageQueue.GetMachineId(String) Methode

Definition

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

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

Ausnahmen

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:

Weitere Informationen