共用方式為


MessageQueue.GetMachineId(String) 方法

定義

取得這個 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,表示佇列所在之電腦的唯一識別項。

例外狀況

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

-或-

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

範例

下列程式碼範例呼叫 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 當計算機新增至企業時,消息佇列所建立的。 訊息佇列會將計算機識別碼與 MachineJournal 關鍵詞結合,以建立計算機日誌的格式名稱,其語法 Machine=<computeridentifier>;Journal為 。 計算機日誌也稱為日誌佇列,是一個系統佇列,會在屬性為 trueUseJournalQueue儲存應用程式產生的訊息複本。

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

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

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

適用於

另請參閱