MessageQueue.GetMachineId(String) 方法

定義

命名空間:

System.Messaging

組件:

System.Messaging.dll

取得這個 MessageQueue 參考之佇列所在位置的電腦識別項。

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

包含佇列的計算機名稱，前面沒有兩個反斜杠 (\\) 。

傳回

Guid

Guid，表示佇列所在之電腦的唯一識別項。

例外狀況

MessageQueueException

無法擷取電腦識別項，可能是因為目錄服務無法使用；例如，如果您是離線工作。

-或-

存取訊息佇列方法時發生錯誤。

範例

下列程式碼範例呼叫 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));

備註

您可以使用計算機的標識碼做為兩個用途，以及其他用途：讀取計算機日誌和設定安全性憑證。 不過，當您離線工作時，無法呼叫 GetMachineId(String) 遠端電腦，因為應用程式必須能夠存取域控制器上的目錄服務。

計算機標識碼 (或計算機標識碼) 是 Guid 當計算機新增至企業時，消息佇列所建立的。 訊息佇列會將計算機識別碼與 Machine 和 Journal 關鍵詞結合，以建立計算機日誌的格式名稱，其語法 Machine=<computeridentifier>;Journal為 。 計算機日誌也稱為日誌佇列，是一個系統佇列，會在屬性為 true時UseJournalQueue儲存應用程式產生的訊息複本。

只有在建構佇列的格式名稱時，日誌的這個語法才有效。 路徑名稱語法為 MachineName\Journal$。

下表顯示此方法是否可在各種工作組模式中使用。

工作組模式	可用
本機電腦	否
本機計算機和直接格式名稱	否
遠端電腦	否
遠端電腦和直接格式名稱	否

另請參閱

• MachineName
• UseJournalQueue