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$.

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

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

Применяется к