MessageQueue.GetMachineId(String) メソッド

定義

名前空間:

System.Messaging

アセンブリ:

System.Messaging.dll

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

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

前の 2 つの円記号 (\\) を含まない、キューを含むコンピューターの名前。

戻り値

Guid

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

例外

MessageQueueException

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

- または -

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

例

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

注釈

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

コンピューター識別子 (またはコンピューター識別子) は、 Guid コンピューターが企業に追加されたときにメッセージ キューによって作成される です。 メッセージ キューでは、コンピューター識別子 Machine と と Journal キーワードを組み合わせて、構文 Machine=<computeridentifier>;Journalを持つコンピューター ジャーナルの形式名を作成します。 ジャーナル キューとも呼ばれるマシン ジャーナルは、 プロパティが の場合にアプリケーションによって生成されたメッセージのコピーを格納する UseJournalQueue システム キューです true。

ジャーナルのこの構文は、キューのフォーマット名を作成する場合にのみ有効です。 パス名の構文は です MachineName\Journal$。

次の表は、このメソッドがさまざまなワークグループ モードで使用できるかどうかを示しています。

ワークグループ モード	利用可能
ローカル コンピューター	いいえ
ローカル コンピューターと直接形式の名前	いいえ
リモート コンピューター	いいえ
リモート コンピューターと直接形式の名前	いいえ

こちらもご覧ください

• MachineName
• UseJournalQueue