MessageQueue.GetMachineId メソッドとは何？わかりやすく解説 Weblio辞書

.NET Framework クラスライブラリリファレンス

索引トップ用語の索引ランキング

MessageQueue.GetMachineId メソッド

この MessageQueue が参照するキューが存在するコンピュータの ID を取得します。

名前空間: System.Messaging
アセンブリ: System.Messaging (system.messaging.dll 内)
構文

Visual Basic (宣言)

Public Shared Function GetMachineId
 ( _
    machineName As String _
) As Guid

Visual Basic (使用法)

Dim machineName As String
Dim returnValue As Guid

returnValue = MessageQueue.GetMachineId(machineName)

public static Guid GetMachineId (
    string machineName
)

C++

public:
static Guid GetMachineId (
    String^ machineName
)

public static Guid GetMachineId (
    String machineName
)

JScript

public static function GetMachineId
 (
    machineName : String
) : Guid

パラメータ

machineName: キューを含むコンピュータの名前。先頭に 2 つの円記号 (\\) を付けません。

戻り値
キューが存在するコンピュータの一意な ID を表す Guid。

例外

例外の種類	条件
MessageQueueException	コンピュータの ID を取得できません。オフラインで作業しているなど、ディレクトリサービスが利用できない可能性があります。またはメッセージキューのメソッドにアクセスしたときにエラーが発生しました。

例外の種類

条件

MessageQueueException

コンピュータの ID を取得できません。オフラインで作業しているなど、ディレクトリサービスが利用できない可能性があります。

または

メッセージキューのメソッドにアクセスしたときにエラーが発生しました。

解説

コンピュータの ID は、特に 2 つの目的に使用できます。コンピュータジャーナルの読み取りとセキュリティ証明書の設定です。しかし、アプリケーションがドメインコントローラのディレクトリサービスにアクセスする必要があるため、オフラインで作業をしているときにリモートコンピュータに対して GetMachineId を呼び出すことはできません。

コンピュータ ID (マシン ID) は、コンピュータがエンタープライズに追加されたときにメッセージキューが作成する Guid です。メッセージキューは、コンピュータ ID を Machine キーワードおよび Journal キーワードと組み合わせて、Machine=<computeridentifier>;Journal 構文を持つコンピュータの履歴の書式名を作成します。コンピュータの履歴は履歴キューとも呼ばれるシステムキューで、UseJournalQueue プロパティが true のときに、アプリケーションが生成したメッセージのコピーが格納されます。

ジャーナルのこの構文は、キューの書式名を構築するときにだけ有効です。パス名構文は MachineName\Journal$ です。

このメソッドが各種のワークグループモードで使用できるかどうかを次の表に示します。

ワークグループモード	使用可否
ローカルコンピュータ	×
ローカルコンピュータと直接書式名	×
リモートコンピュータ	×
リモートコンピュータと直接書式名	×

使用例

GetMachineId を呼び出すコード例を次に示します。

// 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));

// Get the name of the computer that contains the queue.
String machineName = queue.get_MachineName();
// Display the return value of the MessageQueue.GetMachineId method.
Console.WriteLine("MessageQueue.GetMachineId(): {0}", 
    MessageQueue.GetMachineId(machineName));