Compartilhar via


MessageQueue.GetMachineId(String) Método

Definição

Obtém o identificador do computador no qual a fila referenciada por isso 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

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

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.

- ou -

Ocorreu um erro ao acessar um método 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 as palavras-chave para criar o nome do 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 No
Nome do computador local e do formato direto No
Computador remoto No
Computador remoto e nome do formato direto No

Aplica-se a

Confira também