MessageQueue.GetMachineId(String) Methode
Definition
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 Bezeichner des Computers ab, auf den sich die Warteschlange befindet, auf die verwiesen MessageQueue wird.
public:
static Guid GetMachineId(System::String ^ machineName);public static Guid GetMachineId(string machineName);static member GetMachineId : string -> GuidPublic Shared Function GetMachineId (machineName As String) As GuidParameter
- machineName
- String
Der Name des Computers, der die Warteschlange enthält, ohne die beiden vorherigen umgekehrten Schrägstriche (\\).
Gibt zurück
Ein Guid Wert, der einen eindeutigen Bezeichner für den Computer darstellt, auf dem sich die Warteschlange befindet.
Ausnahmen
Der Computerbezeichner konnte nicht abgerufen werden, möglicherweise weil der Verzeichnisdienst nicht verfügbar ist; Beispiel: Wenn Sie offline arbeiten.
- oder -
Fehler beim Zugriff auf eine Message Queuing-Methode.
Beispiele
Das folgende Codebeispiel ruft GetMachineId(String) auf.
// 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 Bezeichner, den Message Queuing erstellt, wenn ein Computer dem Unternehmen hinzugefügt wird. Message Queuing kombiniert den Computerbezeichner mit den Machine Und Journal Schlüsselwörtern, 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 anwendungsgenerierten Nachrichten speichert, wenn die UseJournalQueue Eigenschaft ist true.
Diese Syntax für das Journal ist nur gültig, wenn der Formatname für die Warteschlange erstellt wird. Die Pfadnamensyntax lautet MachineName\Journal$.
In der folgenden Tabelle wird gezeigt, ob diese Methode in verschiedenen Arbeitsgruppenmodi verfügbar ist.
| Arbeitsgruppenmodus | Verfügbar |
|---|---|
| Lokaler Computer | No |
| Name des lokalen Computers und des direkten Formats | No |
| Remotecomputer | No |
| Name des Remotecomputers und des direkten Formats | No |
