다음을 통해 공유


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이 있는 컴퓨터 저널의 형식 이름을 만듭니다. 컴퓨터 저널을 라고도 하는 업무 일지 큐로는 복사본을 저장 하는 시스템 큐 애플리케이션에서 생성 된 경우 메시지를 UseJournalQueue 속성은 true합니다.

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

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

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

적용 대상

추가 정보