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 큐가 있는 컴퓨터의 고유 식별자를 나타내는 A입니다.

예외

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 컴퓨터가 엔터프라이즈에 추가되면 메시지 큐에서 만드는 식별자입니다. 메시지 큐는 컴퓨터 식별자와 MachineJournal 키워드를 결합하여 구문 Machine=<computeridentifier>;Journal이 있는 컴퓨터 저널의 형식 이름을 만듭니다. 저널 큐라고도 하는 컴퓨터 저널은 속성이 있을 때 UseJournalQueue 애플리케이션에서 생성된 메시지의 복사본을 저장하는 시스템 큐입니다 true.

저널의 이 구문은 큐의 형식 이름을 생성할 때만 유효합니다. 경로 이름 구문은 .입니다 MachineName\Journal$.

다음 표에서는 이 메서드를 다양한 작업 그룹 모드에서 사용할 수 있는지 여부를 보여 줍니다.

작업 그룹 모드	사용 가능
로컬 컴퓨터	No
로컬 컴퓨터 및 직접 형식 이름	No
원격 컴퓨터	No
원격 컴퓨터 및 직접 형식 이름	No

추가 정보

• MachineName
• UseJournalQueue