MessageQueue.GetMachineId(String) メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
この 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$
。
次の表は、このメソッドがさまざまなワークグループ モードで使用できるかどうかを示しています。
ワークグループ モード | 利用可能 |
---|---|
ローカル コンピューター | いいえ |
ローカル コンピューターと直接形式の名前 | いいえ |
リモート コンピューター | いいえ |
リモート コンピューターと直接形式の名前 | いいえ |
適用対象
こちらもご覧ください
.NET