Partager via


MessageQueue.GetMachineId(String) Méthode

Définition

Obtient l'identificateur de l'ordinateur sur lequel figure la file d'attente à laquelle ce MessageQueue fait référence.

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 représente un identificateur unique pour l'ordinateur sur lequel figure la file d'attente.

Exceptions

L'identificateur de l'ordinateur n'a pas pu être récupéré. Le service d'annuaire n'est peut-être pas disponible, par exemple, si vous travaillez en mode 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 : 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 en mode 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 que Message Queuing crée lorsqu’un ordinateur est ajouté à l’entreprise. Message Queuing combine l’identificateur d’ordinateur avec les Machine mots clés et Journal 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 journal, est une file d’attente système qui stocke des 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 de 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