MessageQueue.GetMachineId メソッド

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

C#

public static Guid GetMachineId (
    string machineName
)

C++

public:
static Guid GetMachineId (
    String^ machineName
)

J#

public static Guid GetMachineId (
    String machineName
)

JScript

public static function GetMachineId
 (
    machineName : String
) : Guid

パラメータ

machineName

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

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

例外

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

解説

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

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

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

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

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

使用例

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

C#

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

J#

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

.NET Framework のセキュリティ

• 直前の呼び出し元に対する完全な信頼。このメンバは、部分的に信頼されているコードから使用することはできません。詳細については、「」を参照してください。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0

参照

関連項目
MessageQueue クラス
MessageQueue メンバ
System.Messaging 名前空間
MachineName
UseJournalQueue