MessageQueue.GetMachineId(String) Метод

Определение

Пространство имен:

System.Messaging

Сборка:

System.Messaging.dll

Возвращает идентификатор компьютера, на который ссылается очередь, на которую ссылается эта 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

Параметры

machineName

String

Имя компьютера, содержащего очередь, без двух предыдущих обратных косых стеков (\\).

Возвращаемое значение

Guid

Объект, Guid представляющий уникальный идентификатор компьютера, на котором расположена очередь.

Исключения

MessageQueueException

Не удалось получить идентификатор компьютера, возможно, так как служба каталогов недоступна; Например, если вы работаете в автономном режиме.

–или–

Произошла ошибка при доступе к методу очереди сообщений.

Примеры

В следующем примере кода вызывается 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));

Комментарии

Идентификатор компьютера можно использовать для двух целей, среди прочего, для чтения журнала компьютера и задания сертификатов безопасности. Однако при работе в автономном режиме нельзя вызывать GetMachineId(String) удаленный компьютер, так как приложение должно иметь доступ к службе каталогов на контроллере домена.

Идентификатор компьютера (или идентификатор компьютера) — это Guid то, что очередь сообщений создает при добавлении компьютера в предприятие. Очередь сообщений объединяет идентификатор компьютера с ключевыми словами для MachineJournal создания имени формата журнала компьютера, который имеет синтаксис Machine=<computeridentifier>;Journal. Журнал компьютера, который также называется очередью журнала, — это системная очередь, в которой хранятся копии сообщений, созданных приложением, при UseJournalQueue использовании trueсвойства.

Этот синтаксис для журнала действителен только при создании имени формата для очереди. Синтаксис имени пути .MachineName\Journal$

В следующей таблице показано, доступен ли этот метод в различных режимах рабочей группы.

Режим рабочей группы	В наличии
Локальный компьютер	Нет
Имя локального компьютера и прямого формата	Нет
Удаленный компьютер	Нет
Имя удаленного компьютера и прямого формата	Нет

См. также раздел

• MachineName
• UseJournalQueue