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

PDComm.GemFormattedProgramExecutionSnapshot

클래스

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

public sealed class GemFormattedProgramExecutionSnapshot : GemOwnedSnapshot

GemFormattedPrograms.GetExecutionSnapshot 또는 이에 대응하는 GemFormattedProgramsWorker 메서드가 반환합니다. 스냅샷을 만든 시점의 실행 상태, 실행한 프로그램, 대기 중인 동작, 애플리케이션의 종료 보고를 담습니다. 실행이 없는 동안에는 프로그램 접근자가 PdcommStatus.InvalidState로 실패합니다. 호출자가 스냅샷을 소유하며 해제해야 합니다.

멤버

GetApplicationDetailBytes

메서드

애플리케이션이 종료 보고와 함께 전달한 세부 바이트를 가져옵니다.

public byte[] GetApplicationDetailBytes()

스냅샷에 애플리케이션 보고가 없으면 PdcommStatus.InvalidState로 실패합니다.

반환값

세부 정보의 복사본입니다. 보고에 세부 정보가 없으면 비어 있습니다.

참고

  • ObjectDisposedException 예외: 스냅샷이 해제되었습니다.
  • PdcommException 예외: 네이티브 접근자가 실패했습니다. 예를 들어 스냅샷에 요청한 데이터가 없으면 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부터 시작하는 명령 인덱스입니다.

반환값

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

참고

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

GetInfo

메서드

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

public GemFormattedProgramExecutionInfo 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입니다.

GetProgramId

메서드

실행한 프로그램의 프로세스 프로그램 ID(PPID)를 가져옵니다.

public SecsItem GetProgramId()

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

반환값

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

참고

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

GetSoftwareRevision

메서드

실행한 프로그램의 소프트웨어 리비전(SOFTREV)을 가져옵니다.

public string GetSoftwareRevision()

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

반환값

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

참고

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