MessageQueue.GetMachineId(String) Metodo

Definizione

Spazio dei nomi:

System.Messaging

Assembly:

System.Messaging.dll

Ottiene l'identificatore del computer in cui viene posizionata la coda cui MessageQueue fa riferimento.

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

Parametri

machineName

String

Nome del computer che contiene la coda, senza le due barre rovesciata precedenti (\\).

Restituisce

Guid

Oggetto Guid che rappresenta un identificatore univoco del computer in cui viene posizionata la coda.

Eccezioni

MessageQueueException

Non è stato possibile recuperare l'identificatore del computer, probabilmente perché il servizio directory non è disponibile, ad esempio se si sta lavorando in modalità offline.

-oppure-

Si è verificato un errore durante l'accesso a un metodo di Accodamento messaggi.

Esempio

Nell'esempio di codice riportato di seguito viene chiamato il metodo 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));

Commenti

È possibile usare l'identificatore di un computer per due scopi, tra gli altri: per leggere il journal del computer e impostare i certificati di sicurezza. Tuttavia, non è possibile chiamare GetMachineId(String) un computer remoto quando si lavora offline perché l'applicazione deve avere accesso al servizio directory nel controller di dominio.

L'identificatore del computer (o l'identificatore di computer) è un Guid oggetto che l'accodamento messaggi crea quando un computer viene aggiunto all'organizzazione. Accodamento messaggi combina l'identificatore del computer con le Machine parole chiave e Journal per creare il nome di formato del journal del computer, con la sintassi Machine=<computeridentifier>;Journal. Il journal del computer, noto anche come coda del journal, è una coda di sistema che archivia copie di messaggi generati dall'applicazione quando la UseJournalQueue proprietà è true.

Questa sintassi per il journal è valida solo quando si costruisce il nome di formato per la coda. La sintassi del nome del percorso è MachineName\Journal$.

La tabella seguente mostra se questo metodo è disponibile in varie modalità gruppo di lavoro.

Modalità gruppo di lavoro	Disponibile
Computer locale	No
Nome del computer locale e del formato diretto	No
Computer remoto	No
Nome del formato diretto e del computer remoto	No

Vedi anche

• MachineName
• UseJournalQueue