MessageQueue.GetMachineId(String) Método

Definição

Namespace:

System.Messaging

Assembly:

System.Messaging.dll

Obtém o identificador do computador no qual a fila referenciada por este MessageQueue está localizada.

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 anteriores (\\).

Retornos

Guid

Um Guid que representa um identificador exclusivo para o computador no qual a fila está localizada.

Exceções

MessageQueueException

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.

- ou -

Erro ao acessar um método do serviço de Enfileiramento de Mensagens.

Exemplos

O exemplo de código a seguir chama 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: ler o diário do computador e definir certificados de segurança. No entanto, você não pode chamar GetMachineId(String) um computador remoto quando estiver trabalhando offline porque o aplicativo deve ter acesso ao serviço de diretório no controlador de domínio.

O identificador do computador (ou identificador de computador) é um Guid que o Enfileiramento de Mensagens cria quando um computador é adicionado à empresa. O Enfileiramento de Mensagens combina o identificador do computador com as Machine palavras-chave e Journal para criar o nome de formato do diário do computador, que tem a sintaxe Machine=<computeridentifier>;Journal. O diário do computador, que também é conhecido como fila de diários, é uma fila do sistema que armazena cópias de mensagens geradas pelo aplicativo quando a UseJournalQueue propriedade é true.

Essa sintaxe para o diário só é válida ao construir o nome do formato para a fila. A sintaxe do nome do caminho é MachineName\Journal$.

A tabela a seguir mostra se esse método está disponível em vários modos de Grupo de Trabalho.

Modo de grupo de trabalho	Disponível
Computador local	Não
Nome do computador local e do formato direto	Não
Computador remoto	Não
Computador remoto e nome de formato direto	Não

Confira também

• MachineName
• UseJournalQueue