MessageQueue.GetMachineId(String) Método

Definição

Espaço de Nomes:
System.Messaging
Assemblagem:
System.Messaging.dll

Obtém o identificador do computador onde está localizada a fila referenciada por isto 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

Parâmetros

machineName
String

O nome do computador que contém a fila, sem as duas barras anteriores (\\).

Devoluções

Guid

A Guid que representa um identificador único do computador onde 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 estiveres a trabalhar offline.

-ou-

Ocorreu um erro ao aceder a um método de Fila 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));

Observações

Pode usar o identificador de um computador para dois propósitos, entre outros: ler o diário do computador e definir certificados de segurança. No entanto, não pode pedir GetMachineId(String) um computador remoto quando está a trabalhar offline porque a aplicação deve ter acesso ao serviço de diretório no controlador de domínio.

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

Esta 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 seguinte mostra se este método está disponível em vários modos de Grupo de Trabalho.

Modo de grupo de trabalho Available
Computador local No
Computador local e nome do formato direto No
Computador remoto No
Computador remoto e nome do formato direto No

Aplica-se a

Ver também