MessageQueue.GetMachineId(String) Methode

Definitie

Naamruimte:
System.Messaging
Assembly:
System.Messaging.dll

Hiermee wordt de id opgehaald van de computer waarnaar wordt verwezen door de wachtrij waarnaar wordt MessageQueue verwezen.

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

Parameters

machineName
String

De naam van de computer die de wachtrij bevat, zonder de twee voorgaande backslashes (\\).

Retouren

Guid

Een Guid die een unieke id vertegenwoordigt voor de computer waarop de wachtrij zich bevindt.

Uitzonderingen

MessageQueueException

De computer-id kan niet worden opgehaald, mogelijk omdat de adreslijstservice niet beschikbaar is; Als u bijvoorbeeld offline werkt.

– of –

Er is een fout opgetreden bij het openen van een Message Queuing-methode.

Voorbeelden

In het volgende codevoorbeeld wordt GetMachineId(String) aangeroepen.

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

Opmerkingen

U kunt onder andere de id van een computer gebruiken voor twee doeleinden: het computerlogboek lezen en beveiligingscertificaten instellen. U kunt echter geen externe computer aanroepen GetMachineId(String) wanneer u offline werkt, omdat de toepassing toegang moet hebben tot de adreslijstservice op de domeincontroller.

De computer-id (of computer-id) is een Guid id die Door Message Queuing wordt gemaakt wanneer een computer wordt toegevoegd aan de onderneming. Message Queuing combineert de computer-id met de Machine en Journal trefwoorden om de notatienaam van het machinelogboek te maken, die de syntaxis Machine=<computeridentifier>;Journalheeft. Het machinelogboek, ook wel bekend als de logboekwachtrij, is een systeemwachtrij waarin kopieën van door de toepassing gegenereerde berichten worden opgeslagen wanneer de UseJournalQueue eigenschap is true.

Deze syntaxis voor het logboek is alleen geldig wanneer u de notatienaam voor de wachtrij samenstelt. De syntaxis van de padnaam is MachineName\Journal$.

In de volgende tabel ziet u of deze methode beschikbaar is in verschillende werkgroepmodi.

Werkgroepmodus Available
Lokale computer No
Naam van lokale computer en directe indeling No
Externe computer No
Naam van externe computer en directe indeling No

Van toepassing op

Zie ook