Partager via

MessageQueue.GetMachineId(String) Méthode

Définition

Espace de noms:
System.Messaging
Assembly:
System.Messaging.dll

Obtient l’identificateur de l’ordinateur sur lequel se trouve la file d’attente référencée par celui-ci 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

Paramètres

machineName
String

Nom de l’ordinateur qui contient la file d’attente, sans les deux barres obliques inverses précédentes (\\).

Retours

Guid

Qui Guid représente un identificateur unique pour l’ordinateur sur lequel se trouve la file d’attente.

Exceptions

MessageQueueException

L’identificateur de l’ordinateur n’a pas pu être récupéré, peut-être parce que le service d’annuaire n’est pas disponible ; par exemple, si vous travaillez hors connexion.

- ou -

Une erreur s’est produite lors de l’accès à une méthode Message Queuing.

Exemples

L’exemple de code suivant appelle 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));

Remarques

Vous pouvez utiliser l’identificateur d’un ordinateur à deux fins, entre autres : pour lire le journal de l’ordinateur et définir des certificats de sécurité. Toutefois, vous ne pouvez pas appeler GetMachineId(String) un ordinateur distant lorsque vous travaillez hors connexion, car l’application doit avoir accès au service d’annuaire sur le contrôleur de domaine.

L’identificateur d’ordinateur (ou identificateur d’ordinateur) est un Guid message queuing crée lorsqu’un ordinateur est ajouté à l’entreprise. Message Queuing combine l’identificateur d’ordinateur avec les mots clés et Journal les Machine mots clés pour créer le nom de format du journal de l’ordinateur, qui a la syntaxe Machine=<computeridentifier>;Journal. Le journal de l’ordinateur, également appelé file d’attente de journaux, est une file d’attente système qui stocke les copies des messages générés par l’application lorsque la UseJournalQueue propriété est true.

Cette syntaxe pour le journal est valide uniquement lors de la construction du nom de format de la file d’attente. La syntaxe du nom du chemin d’accès est MachineName\Journal$.

Le tableau suivant indique si cette méthode est disponible dans différents modes de groupe de travail.

Mode groupe de travail Disponible
Ordinateur local Non
Ordinateur local et nom de format direct Non
Ordinateur distant Non
Ordinateur distant et nom de format direct Non

S’applique à

Voir aussi