MessageQueue.GetMachineId(String) Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
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 |