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

PDComm.GemFormattedProgramStoreSnapshot

클래스

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

public sealed class GemFormattedProgramStoreSnapshot : GemOwnedSnapshot

GemFormattedPrograms.GetStoreSnapshot 또는 이에 대응하는 GemFormattedProgramsWorker 메서드가 반환합니다. 스냅샷을 만든 시점의 저장소 정보와 저장된 모든 프로세스 프로그램을 담으며, 이후 저장소가 바뀌거나 끝점이 해제된 뒤에도 유효합니다. 프로그램은 0부터 시작하는 항목 인덱스로 지정합니다. 호출자가 스냅샷을 소유하며 해제해야 합니다.

멤버

GetEntryCommandCode

메서드

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

public SecsItem GetEntryCommandCode(nuint entry_index, nuint command_index)

매개변수

이름설명
entry_index저장된 프로그램의 0부터 시작하는 인덱스이며 GemFormattedProgramStoreInfo.EntryCount보다 작아야 합니다.
command_index0부터 시작하는 명령 인덱스입니다.

반환값

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

참고

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

GetEntryCommandInfo

메서드

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

public GemFormattedProgramCommandInfo GetEntryCommandInfo(nuint entry_index, nuint command_index)

매개변수

이름설명
entry_index저장된 프로그램의 0부터 시작하는 인덱스이며 GemFormattedProgramStoreInfo.EntryCount보다 작아야 합니다.
command_index0부터 시작하는 명령 인덱스이며 GemFormattedProgramStoreEntryInfo.CommandCount보다 작아야 합니다.

반환값

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

참고

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

GetEntryId

메서드

저장된 프로그램 하나의 프로세스 프로그램 ID(PPID)를 가져옵니다.

public SecsItem GetEntryId(nuint entry_index)

매개변수

이름설명
entry_index저장된 프로그램의 0부터 시작하는 인덱스이며 GemFormattedProgramStoreInfo.EntryCount보다 작아야 합니다.

반환값

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

참고

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

GetEntryInfo

메서드

저장된 프로그램 하나의 설명을 가져옵니다.

public GemFormattedProgramStoreEntryInfo GetEntryInfo(nuint entry_index)

매개변수

이름설명
entry_index저장된 프로그램의 0부터 시작하는 인덱스이며 GemFormattedProgramStoreInfo.EntryCount보다 작아야 합니다.

반환값

프로그램의 명령 수와 PPID 형식입니다.

참고

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

GetEntryModel

메서드

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

public string GetEntryModel(nuint entry_index)

매개변수

이름설명
entry_index저장된 프로그램의 0부터 시작하는 인덱스이며 GemFormattedProgramStoreInfo.EntryCount보다 작아야 합니다.

반환값

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

참고

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

GetEntryParameter

메서드

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

public SecsItem GetEntryParameter(nuint entry_index, nuint command_index, nuint parameter_index)

매개변수

이름설명
entry_index저장된 프로그램의 0부터 시작하는 인덱스이며 GemFormattedProgramStoreInfo.EntryCount보다 작아야 합니다.
command_index0부터 시작하는 명령 인덱스입니다.
parameter_index명령 안에서 0부터 시작하는 매개변수 인덱스입니다.

반환값

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

참고

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

GetEntrySoftwareRevision

메서드

저장된 프로그램 하나의 소프트웨어 리비전(SOFTREV)을 가져옵니다.

public string GetEntrySoftwareRevision(nuint entry_index)

매개변수

이름설명
entry_index저장된 프로그램의 0부터 시작하는 인덱스이며 GemFormattedProgramStoreInfo.EntryCount보다 작아야 합니다.

반환값

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

참고

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

GetSnapshotInfo

메서드

스냅샷이 기록한 저장소 정보를 가져옵니다.

public GemFormattedProgramStoreInfo GetSnapshotInfo()

반환값

스냅샷 시점의 저장소 리비전, 사용량, 한도입니다.

참고

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

개인정보 처리방침