MessageQueue.GetMachineId(String) Método
Definição
Obtém o identificador do computador no qual a fila referenciada por este MessageQueue está localizada.Gets the identifier of the computer on which the queue referenced by this MessageQueue is located.
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
Parâmetros
- machineName
- String
O nome do computador que contém a fila sem as duas barras invertidas no início (\\).The name of the computer that contains the queue, without the two preceding backslashes (\\).
Retornos
Um Guid que representa um identificador exclusivo para o computador no qual a fila está localizada.A Guid that represents a unique identifier for the computer on which the queue is located.
Exceções
O identificador do computador não pôde ser recuperado, possivelmente porque o serviço de diretório não está disponível. Por exemplo, se você estiver trabalhando offline.The computer identifier could not be retrieved, possibly because the directory service is not available; for example, if you are working offline.
- ou --or-
Erro ao acessar um método do serviço de Enfileiramento de Mensagens.An error occurred when accessing a Message Queuing method.
Exemplos
O exemplo de código a seguir chama GetMachineId(String).The following code example calls 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));
Comentários
Você pode usar o identificador de um computador para duas finalidades, entre outras: para ler o diário do computador e definir certificados de segurança.You can use a computer's identifier for two purposes, among others: to read the computer journal and to set security certificates. No entanto, você não pode chamar GetMachineId(String) para um computador remoto quando estiver trabalhando offline porque o aplicativo deve ter acesso ao serviço de diretório no controlador de domínio.However, you cannot call GetMachineId(String) for a remote computer when you are working offline because the application must have access to the directory service on the domain controller.
O identificador do computador (ou identificador da máquina) é Guid aquele que o enfileiramento de mensagens cria quando um computador é adicionado à empresa.The computer identifier (or machine identifier) is a Guid that Message Queuing creates when a computer is added to the enterprise. O enfileiramento de mensagens combina o identificador do computador com as Machine Journal palavras-chave e para criar o nome do formato do diário do computador, que tem a sintaxe Machine=<computeridentifier>;Journal .Message Queuing combines the computer identifier with the Machine and Journal keywords to create the machine journal's format name, which has the syntax Machine=<computeridentifier>;Journal. O diário do computador, que também é conhecido como fila do diário, é uma fila do sistema que armazena cópias de mensagens geradas pelo aplicativo quando a UseJournalQueue propriedade é true .The machine journal, which is also known as the journal queue, is a system queue that stores copies of application-generated messages when the UseJournalQueue property is true.
Essa sintaxe para o diário só é válida ao construir o nome de formato para a fila.This syntax for the journal is only valid when constructing the format name for the queue. A sintaxe do nome do caminho é MachineName \ Journal$ .The path name syntax is MachineName\Journal$.
A tabela a seguir mostra se esse método está disponível em vários modos de grupo de trabalho.The following table shows whether this method is available in various Workgroup modes.
| Modo de grupo de trabalhoWorkgroup mode | DisponívelAvailable |
|---|---|
| Computador localLocal computer | NãoNo |
| Computador local e nome de formato diretoLocal computer and direct format name | NãoNo |
| Computador remotoRemote computer | NãoNo |
| Computador remoto e nome de formato diretoRemote computer and direct format name | NãoNo |