MessageQueue.GetMachineId(String) Método

  • Referencia

Definición

Espacio de nombres:
System.Messaging
Ensamblado:
System.Messaging.dll

Obtiene el identificador del equipo en el que se encuentra la cola a la que hace referencia 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

Nombre del equipo que contiene la cola, sin las dos barras diagonales inversas anteriores (\\).

Devoluciones

Guid

Guid que representa un identificador único para el equipo en el que se encuentra la cola.

Excepciones

MessageQueueException

No se pudo recuperar el identificador del equipo, posiblemente porque el servicio de directorio no está disponible; sucedería, por ejemplo, si se estuviese trabajando sin conexión.

o bien

Error al obtener acceso a un método de Message Queuing.

Ejemplos

En el ejemplo de código siguiente se llama a 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));

Comentarios

Puede usar el identificador de un equipo con dos fines, entre otros: para leer el diario del equipo y establecer certificados de seguridad. Sin embargo, no puede llamar a GetMachineId(String) un equipo remoto cuando esté trabajando sin conexión porque la aplicación debe tener acceso al servicio de directorio en el controlador de dominio.

El identificador de equipo (o identificador de equipo) es un Guid objeto que Message Queuing crea cuando se agrega un equipo a la empresa. Message Queuing combina el identificador de equipo con las Machine palabras clave y Journal para crear el nombre de formato del diario de la máquina, que tiene la sintaxis Machine=<computeridentifier>;Journal. El diario de la máquina, que también se conoce como cola de diario, es una cola del sistema que almacena copias de los mensajes generados por la aplicación cuando la UseJournalQueue propiedad es true.

Esta sintaxis para el diario solo es válida al construir el nombre de formato para la cola. La sintaxis del nombre de ruta de acceso es MachineName\Journal$.

En la tabla siguiente se muestra si este método está disponible en varios modos de grupo de trabajo.

Modo de grupo de trabajo Disponible
Equipo local No
Equipo local y nombre de formato directo No
Equipo remoto No
Equipo remoto y nombre de formato directo No

Se aplica a

Consulte también