콘텐츠로 이동
무료 평가 시작

PDComm.GemFormattedProgramSelectionSnapshot

클래스

장비의 정형 프로세스 프로그램 선택에 대한 읽기 전용 복사본입니다.

public sealed class GemFormattedProgramSelectionSnapshot : GemOwnedSnapshot

GemFormattedPrograms.GetSelectionSnapshot과 GemFormattedPrograms.ValidateSelection, 또는 이에 대응하는 GemFormattedProgramsWorker 메서드가 반환합니다. 선택 상태와, 프로그램을 선택할 때 만든 프로그램 복사본을 담습니다. 이 복사본은 이후 저장소 변경을 따라가지 않습니다. 아무것도 선택되지 않은 동안에는 GemFormattedProgramSelectionSnapshot.GetInfo만 성공하며 프로그램 접근자는 PdcommStatus.InvalidState로 실패합니다. 호출자가 스냅샷을 소유하며 해제해야 합니다.

멤버

GetCommandCode

메서드

선택된 프로그램에 있는 명령 하나의 명령 코드(CCODE)를 가져옵니다.

public SecsItem GetCommandCode(nuint command_index)

스냅샷에 선택이 없으면 PdcommStatus.InvalidState로 실패합니다.

매개변수

이름설명
command_index0부터 시작하는 명령 인덱스입니다.

반환값

ASCII 또는 부호 없는 정수 명령 코드(CCODE)를 담은 새 SecsItem입니다. 호출자가 반환된 아이템을 소유하며 해제해야 합니다.

참고

  • ObjectDisposedException 예외: 스냅샷이 해제되었습니다.
  • PdcommException 예외: 네이티브 접근자가 실패했습니다. 예를 들어 스냅샷에 요청한 데이터가 없으면 PdcommStatus.InvalidState이고, 인덱스가 끝을 넘었거나 해당 인덱스의 항목이 없으면 PdcommStatus.OutOfRange입니다.

GetCommandInfo

메서드

선택된 프로그램에 있는 명령 하나의 매개변수 수와 명령 코드 형식을 가져옵니다.

public GemFormattedProgramCommandInfo GetCommandInfo(nuint command_index)

스냅샷에 선택이 없으면 PdcommStatus.InvalidState로 실패합니다.

매개변수

이름설명
command_index0부터 시작하는 명령 인덱스이며 GemFormattedProgramSelectionInfo.CommandCount보다 작아야 합니다.

반환값

명령의 매개변수 수와 명령 코드(CCODE)의 SECS-II 형식입니다.

참고

  • ObjectDisposedException 예외: 스냅샷이 해제되었습니다.
  • PdcommException 예외: 네이티브 접근자가 실패했습니다. 예를 들어 스냅샷에 요청한 데이터가 없으면 PdcommStatus.InvalidState이고, 인덱스가 끝을 넘었거나 해당 인덱스의 항목이 없으면 PdcommStatus.OutOfRange입니다.

GetId

메서드

선택된 프로그램의 프로세스 프로그램 ID(PPID)를 가져옵니다.

public SecsItem GetId()

스냅샷에 선택이 없으면 PdcommStatus.InvalidState로 실패합니다.

반환값

PPID를 담은 새 ASCII 또는 바이너리 SecsItem입니다. 호출자가 반환된 아이템을 소유하며 해제해야 합니다.

참고

  • ObjectDisposedException 예외: 스냅샷이 해제되었습니다.
  • PdcommException 예외: 네이티브 접근자가 실패했습니다. 예를 들어 스냅샷에 요청한 데이터가 없으면 PdcommStatus.InvalidState입니다.

GetInfo

메서드

스냅샷이 기록한 선택 상태를 가져옵니다.

public GemFormattedProgramSelectionInfo GetInfo()

반환값

선택 상태, 무효화 이유, 선택의 세대입니다.

참고

  • ObjectDisposedException 예외: 스냅샷이 해제되었습니다.
  • PdcommException 예외: 네이티브 접근자가 실패했습니다. 예를 들어 스냅샷에 요청한 데이터가 없으면 PdcommStatus.InvalidState입니다.

GetModel

메서드

선택된 프로그램의 장비 모델 유형(MDLN)을 가져옵니다.

public string GetModel()

스냅샷에 선택이 없으면 PdcommStatus.InvalidState로 실패합니다.

반환값

장비 모델 유형(MDLN) 텍스트입니다.

참고

  • ObjectDisposedException 예외: 스냅샷이 해제되었습니다.
  • PdcommException 예외: 네이티브 접근자가 실패했습니다. 예를 들어 스냅샷에 요청한 데이터가 없으면 PdcommStatus.InvalidState입니다.

GetParameter

메서드

선택된 프로그램에 있는 명령 하나의 매개변수(PPARM) 하나를 가져옵니다.

public SecsItem GetParameter(nuint command_index, nuint parameter_index)

스냅샷에 선택이 없으면 PdcommStatus.InvalidState로 실패합니다.

매개변수

이름설명
command_index0부터 시작하는 명령 인덱스입니다.
parameter_index명령 안에서 0부터 시작하는 매개변수 인덱스입니다.

반환값

매개변수(PPARM)를 담은 새 SecsItem입니다. 호출자가 반환된 아이템을 소유하며 해제해야 합니다.

참고

  • ObjectDisposedException 예외: 스냅샷이 해제되었습니다.
  • PdcommException 예외: 네이티브 접근자가 실패했습니다. 예를 들어 스냅샷에 요청한 데이터가 없으면 PdcommStatus.InvalidState이고, 인덱스가 끝을 넘었거나 해당 인덱스의 항목이 없으면 PdcommStatus.OutOfRange입니다.

GetSoftwareRevision

메서드

선택된 프로그램의 소프트웨어 리비전(SOFTREV)을 가져옵니다.

public string GetSoftwareRevision()

스냅샷에 선택이 없으면 PdcommStatus.InvalidState로 실패합니다.

반환값

소프트웨어 리비전(SOFTREV) 텍스트입니다.

참고

  • ObjectDisposedException 예외: 스냅샷이 해제되었습니다.
  • PdcommException 예외: 네이티브 접근자가 실패했습니다. 예를 들어 스냅샷에 요청한 데이터가 없으면 PdcommStatus.InvalidState입니다.

개인정보 처리방침