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 , который очередь сообщений создает при добавлении компьютера в предприятие. Очередь сообщений объединяет идентификатор компьютера с ключевыми словами Machine и , Journal чтобы создать имя формата журнала компьютера с синтаксисом Machine=<computeridentifier>;Journal. Журнал компьютера, который также называется очередью журналов, — это системная очередь, в которой хранятся копии сообщений, созданных приложением UseJournalQueue , если свойство имеет значение true.

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

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

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

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

• MachineName
• UseJournalQueue