MessageQueue.GetMachineId(String) メソッド

定義

この 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 つの円記号 (\\) を含まない、キューを含むコンピューターの名前。

戻り値

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

例外

コンピューターの 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$

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

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

適用対象

こちらもご覧ください