Condividi tramite


MessageQueue.GetMachineId(String) Metodo

Definizione

Ottiene l'identificatore del computer in cui si trova la coda a cui fa riferimento.MessageQueue

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

Oggetto Guid che rappresenta un identificatore univoco per il computer in cui si trova la coda.

Eccezioni

Impossibile recuperare l'identificatore del computer, probabilmente perché il servizio directory non è disponibile; ad esempio, se si lavora offline.

oppure

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

Esempio

Nell'esempio di codice seguente viene chiamato 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 per 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 del computer) è un Guid oggetto creato da Accodamento messaggi 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 journal, è una coda di sistema che archivia le copie dei messaggi generati dall'applicazione quando la UseJournalQueue proprietà è true.

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

Nella tabella seguente viene illustrato se questo metodo è disponibile in varie modalità gruppo di lavoro.

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

Si applica a

Vedi anche