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

PDComm.GemResult

클래스

GEM 계층으로 전송 이벤트 하나를 처리한 결과를 나타냅니다.

public sealed class GemResult : IDisposable

결과는 GemEndpoint.HandleEvent 또는 GemEvent.Result에서 가져오며, GemResult.GetInfo부터 시작합니다. 결과는 데이터 스냅샷을 담은 네이티브 메모리를 소유하므로 사용이 끝나면 해제합니다. 원래의 HsmsEvent와 끝점이 해제된 뒤에도 유효합니다.

getter가 반환하는 모든 SecsItem은 호출자가 소유하며 해제해야 하는 독립된 새 객체이며, 결과를 해제한 뒤에도 유효합니다. 한 결과에 대한 호출은 내부 잠금으로 직렬화됩니다.

멤버

Dispose

메서드

네이티브 결과를 해제합니다.

public void Dispose()

결과에서 이미 반환된 아이템과 값은 계속 유효합니다.

GetAlarmAt

메서드

결과에 담긴 알람 보고 또는 알람 목록의 알람 항목 하나를 가져옵니다.

public GemAlarmValue GetAlarmAt(nuint index)

항목에는 전송된 필드만 들어 있습니다. 장비의 활성화 상태와 이벤트 매핑은 메시지에 포함되지 않습니다.

매개변수

이름설명
index0부터 시작하는 항목 인덱스입니다. 보고에는 항목이 하나 있고, 목록에는 GemAlarmResultInfo.Count개의 항목이 전송 순서대로 있습니다.

반환값

전송된 알람 ID, 범주, 활성 상태, 텍스트입니다.

참고

  • ObjectDisposedException 예외: 결과가 해제되었습니다.
  • PdcommException 예외: index가 범위를 벗어나면 PdcommStatus.OutOfRange, 결과가 알람 보고나 목록이 아니면 PdcommStatus.InvalidState이거나, 그 밖의 네이티브 실패 상태입니다.
  • InvalidOperationException 예외: 크기 조회와 복사 사이에 네이티브 텍스트 크기가 바뀌었습니다.

GetAlarmInfo

메서드

결과에 담긴 알람 보고 또는 알람 목록의 요약을 가져옵니다.

public GemAlarmResultInfo GetAlarmInfo()

결과는 결과를 만든 끝점이 해제된 뒤에도 읽을 수 있습니다.

반환값

항목 수, 결과가 보고인지 여부, W 비트, 확인 응답 상태입니다.

참고

  • ObjectDisposedException 예외: 결과가 해제되었습니다.
  • PdcommException 예외: 결과가 검증된 호스트 쪽 알람 보고(S5F1)나 알람 목록 응답(S5F6 또는 S5F8)이 아니면 PdcommStatus.InvalidState이거나, 그 밖의 네이티브 실패 상태입니다.

GetBody

메서드

결과와 함께 기록된 SECS-II 본문의 복사본을 가져옵니다.

public SecsItem? GetBody()

반환값

호출자가 소유하며 해제해야 하는 새 아이템이거나, 결과에 본문이 없으면 null입니다. 예를 들어 헤더만 있는 메시지, 실패, 디코딩할 수 없는 본문이 해당합니다.

참고

  • ObjectDisposedException 예외: 결과가 해제되었습니다.
  • PdcommException 예외: 네이티브 복사가 실패했습니다. 예를 들면 PdcommStatus.AllocationFailed입니다.

GetCommandInfo

메서드

결과에 담긴 원격 명령 요청 또는 응답의 요약을 가져옵니다.

public GemCommandResultInfo GetCommandInfo()

GemEquipment.RespondCommand가 실제로 보낸 HCACK는 GemResultInfo.Acknowledgement로 보고됩니다. 결과는 결과를 만든 끝점이 해제된 뒤에도 읽을 수 있습니다.

반환값

매개변수 수와 문제 수, 수신 시 검증 결과, 완료 이벤트, 응답 상태입니다.

참고

  • ObjectDisposedException 예외: 결과가 해제되었습니다.
  • PdcommException 예외: 결과가 검증된 S2F41 요청이나 S2F42 응답이 아니면 PdcommStatus.InvalidState이거나, 그 밖의 네이티브 실패 상태입니다.

GetCommandIssue

메서드

원격 명령 결과의 매개변수 확인 응답(CPNAME과 CPACK) 하나를 가져옵니다.

public GemCommandError GetCommandIssue(nuint index)

요청이면 문제는 수신 시 검증에서 찾은 것이며, 숫자 이름은 I8 또는 U8 아이템으로 반환되므로 전송 형식과 다를 수 있습니다. 호스트 쪽 응답이면 문제는 받은 CPACK 항목이며 이름은 전송 형식 그대로입니다.

매개변수

이름설명
index0부터 시작하는 문제 인덱스입니다. 순서와 중복은 유지됩니다.

반환값

매개변수 이름과 CPACK 코드입니다. 호출자는 반환된 오류를 해제해야 합니다.

참고

  • ObjectDisposedException 예외: 결과가 해제되었습니다.
  • PdcommException 예외: index가 GemCommandResultInfo.IssueCount보다 작지 않으면 PdcommStatus.OutOfRange, 결과가 원격 명령 결과가 아니면 PdcommStatus.InvalidState이거나, 그 밖의 네이티브 실패 상태입니다.

GetCommandName

메서드

수신한 S2F41 요청의 원격 명령 이름(RCMD)을 가져옵니다.

public SecsItem GetCommandName()

반환값

전송된 형식 그대로인 이름 아이템의 독립 복사본입니다. 호출자가 해제해야 합니다.

참고

  • ObjectDisposedException 예외: 결과가 해제되었습니다.
  • PdcommException 예외: 결과가 S2F41 요청이 아니면(예: 호스트 쪽 응답) PdcommStatus.InvalidState이거나, 그 밖의 네이티브 실패 상태입니다.

GetCommandParameter

메서드

수신한 S2F41 요청의 매개변수 하나를 가져옵니다.

public GemCommandArgument GetCommandParameter(nuint index)

매개변수

이름설명
index전송 순서에서 0부터 시작하는 매개변수 인덱스입니다. 중복은 유지됩니다.

반환값

매개변수 이름(CPNAME)과 값(CPVAL)의 독립 복사본입니다. 호출자는 반환된 인수를 해제해야 합니다.

참고

  • ObjectDisposedException 예외: 결과가 해제되었습니다.
  • PdcommException 예외: index가 GemCommandResultInfo.ParameterCount보다 작지 않으면 PdcommStatus.OutOfRange, 결과가 S2F41 요청이 아니면 PdcommStatus.InvalidState이거나, 그 밖의 네이티브 실패 상태입니다.

GetConstantChange

메서드

수신한 S2F15 요청의 ECID/ECV 쌍 하나를 가져옵니다.

public GemConstantChangeEntry GetConstantChange(nuint index)

매개변수

이름설명
index0부터 시작하는 쌍 인덱스이며 GemConstantChangeInfo.ChangeCount보다 작아야 합니다.

반환값

호출자가 소유하며 해제해야 하는 새 항목입니다. 전송 형식과 순서 그대로인 제안된 ID와 값, 그리고 수신 시점의 상수 값(알 수 없는 ID이면 null)을 담습니다.

참고

  • ObjectDisposedException 예외: 결과가 해제되었습니다.
  • PdcommException 예외: 결과가 수신한 S2F15 요청이 아니면 PdcommStatus.InvalidState이고, index가 너무 크면 PdcommStatus.OutOfRange입니다.

GetConstantChangeInfo

메서드

수신한 S2F15 요청 또는 S2F16 응답의 처리 상태를 가져옵니다.

public GemConstantChangeInfo GetConstantChangeInfo()

반환값

S2F15 요청(GemOutcome.ConstantChangesReceived)이면 수신 검증과 응답 상태이고, S2F16 응답(GemOutcome.ConstantChangeAck)이면 GemConstantChangeInfo.IsRequest가 false이고 나머지가 모두 0인 값입니다.

참고

  • ObjectDisposedException 예외: 결과가 해제되었습니다.
  • PdcommException 예외: 결과가 S2F15 요청도 S2F16 응답도 아니면 PdcommStatus.InvalidState입니다.

GetConstantMetadata

메서드

수신한 S2F30(Equipment Constant Namelist) 응답에 있는 항목의 필드 하나를 가져옵니다.

public SecsItem GetConstantMetadata(nuint index, GemConstantField field)

매개변수

이름설명
index0부터 시작하는 항목 인덱스이며 GemResultInfo.EntryCount보다 작아야 합니다.
field필드이며 GemConstantField.Id부터 GemConstantField.Units까지입니다.

반환값

받은 그대로인, 호출자가 소유하며 해제해야 하는 새 아이템입니다. 빈 ASCII 아이템은 값이 없거나 ID를 알 수 없다는 뜻일 수 있으며, 응답은 어느 쪽인지 알려 주지 않습니다.

참고

  • ObjectDisposedException 예외: 결과가 해제되었습니다.
  • PdcommException 예외: field가 GemConstantField.Current이거나 정의되지 않았으면 PdcommStatus.InvalidArgument, 결과가 상수 메타데이터 응답(GemOutcome.ConstantMetadataReceived)이 아니면 PdcommStatus.InvalidState, index가 너무 크면 PdcommStatus.OutOfRange입니다.

GetConstantValue

메서드

수신한 S2F14(Equipment Constant Data) 응답의 항목 하나를 가져옵니다.

public GemConstantValue GetConstantValue(nuint index)

매개변수

이름설명
index0부터 시작하는 항목 인덱스이며 GemResultInfo.EntryCount보다 작아야 합니다.

반환값

호출자가 소유하며 해제해야 하는 새 항목입니다. ID는 원래 요청의 해당 ID이며, 모든 상수를 요청했으면 null입니다.

참고

  • ObjectDisposedException 예외: 결과가 해제되었습니다.
  • PdcommException 예외: 결과가 상수 값 응답(GemOutcome.ConstantValuesReceived)이 아니면 PdcommStatus.InvalidState이고, index가 너무 크면 PdcommStatus.OutOfRange입니다.

GetDirectory

메서드

수신한 이름 목록 응답(S1F22 또는 S1F24)에 있는 행의 필드 하나를 새 아이템으로 가져옵니다.

public SecsItem GetDirectory(nuint index, GemDirectoryField field)

반환된 아이템은 결과와 끝점을 해제한 뒤에도 유효합니다.

매개변수

이름설명
index0부터 시작하는 행 위치이며 GemResultInfo.EntryCount보다 작아야 합니다.
field데이터 변수 행이면 GemDirectoryField.Name 또는 GemDirectoryField.Units(ASCII 아이템)이고, 이벤트 행이면 GemDirectoryField.Name(ASCII) 또는 GemDirectoryField.VariableIds(U4 배열)입니다.

반환값

호출자가 소유하며 해제해야 하는 새 아이템입니다.

참고

  • ObjectDisposedException 예외: 결과가 해제되었습니다.
  • PdcommException 예외: 호출이 실패했습니다. field가 행 종류에 유효하지 않으면 PdcommStatus.InvalidArgument, 결과가 검증된 디렉터리 응답이 아니면 PdcommStatus.InvalidState, index가 범위를 벗어나면 PdcommStatus.OutOfRange, 행 형식이 잘못되었으면 PdcommStatus.InvalidData입니다.
  • InvalidOperationException 예외: 네이티브 라이브러리가 아이템을 반환하지 않았습니다.

GetDirectoryAt

메서드

수신한 이름 목록 응답(S1F22 또는 S1F24)에 있는 행 하나의 ID와 변수 수를 가져옵니다.

public GemDirectoryEntryInfo GetDirectoryAt(nuint index)

매개변수

이름설명
index0부터 시작하는 행 위치이며 GemResultInfo.EntryCount보다 작아야 합니다.

반환값

데이터 변수 행이면 VID, 이벤트 행이면 CEID와, 변수 ID의 수(데이터 변수 행은 0)입니다.

참고

  • ObjectDisposedException 예외: 결과가 해제되었습니다.
  • PdcommException 예외: 네이티브 호출이 실패했습니다. 결과가 검증된 디렉터리 응답이 아니면 PdcommStatus.InvalidState, index가 범위를 벗어나면 PdcommStatus.OutOfRange, 행 형식이 잘못되었으면 PdcommStatus.InvalidData입니다.

GetEnhancedCommandAcknowledgements

메서드

확장 원격 명령 결과의 매개변수 확인 목록을 가져옵니다.

public SecsItem GetEnhancedCommandAcknowledgements()

로컬 검증에서 나온 이름은 정규화된 숫자 형식을 사용할 수 있습니다.

반환값

외부 List 아이템의 독립 복사본입니다. 수락된 요청이면 비어 있고, 거부된 요청이면 수신 시 고정된 검증 오류이며, 호스트 쪽 응답이면 수신한 S2F50의 두 번째 필드 그대로입니다. 호출자가 해제해야 합니다.

참고

  • ObjectDisposedException 예외: 결과가 해제되었습니다.
  • PdcommException 예외: 결과가 확장 원격 명령 결과가 아니면 PdcommStatus.InvalidState이거나, 그 밖의 네이티브 실패 상태입니다.

GetEnhancedCommandInfo

메서드

결과에 담긴 확장 원격 명령 요청 또는 응답의 요약을 가져옵니다.

public GemEnhancedCommandResultInfo GetEnhancedCommandInfo()

GemEquipment.RespondEnhancedCommand가 실제로 보낸 HCACK는 GemResultInfo.Acknowledgement로 보고됩니다. 결과는 결과를 만든 끝점이 해제된 뒤에도 읽을 수 있습니다.

반환값

매개변수 수와 문제 수, 데이터 ID, 수신 시 검증 결과, 완료 이벤트, 응답 상태입니다.

참고

  • ObjectDisposedException 예외: 결과가 해제되었습니다.
  • PdcommException 예외: 결과가 S2F49 요청이나 S2F50 응답이 아니면 PdcommStatus.InvalidState이거나, 그 밖의 네이티브 실패 상태입니다.

GetEnhancedCommandName

메서드

수신한 S2F49 요청의 원격 명령 이름(RCMD)을 가져옵니다.

public SecsItem GetEnhancedCommandName()

반환값

전송된 형식 그대로인 이름 아이템의 독립 복사본입니다. 호출자가 해제해야 합니다.

참고

  • ObjectDisposedException 예외: 결과가 해제되었습니다.
  • PdcommException 예외: 결과가 S2F49 요청이 아니면(예: 호스트 쪽 응답) PdcommStatus.InvalidState이거나, 그 밖의 네이티브 실패 상태입니다.

GetEnhancedCommandObject

메서드

수신한 S2F49 요청의 객체 지정자(OBJSPEC)를 가져옵니다.

public SecsItem GetEnhancedCommandObject()

반환값

ASCII 객체 아이템의 독립 복사본입니다. 호출자가 해제해야 합니다.

참고

  • ObjectDisposedException 예외: 결과가 해제되었습니다.
  • PdcommException 예외: 결과가 S2F49 요청이 아니면(예: 호스트 쪽 응답) PdcommStatus.InvalidState이거나, 그 밖의 네이티브 실패 상태입니다.

GetEnhancedCommandParameter

메서드

수신한 S2F49 요청의 매개변수 하나를 가져옵니다.

public GemCommandArgument GetEnhancedCommandParameter(nuint index)

매개변수

이름설명
index전송 순서에서 0부터 시작하는 매개변수 인덱스입니다.

반환값

매개변수 이름(CPNAME)과 값(CEPVAL)의 독립 복사본입니다. 호출자는 반환된 인수를 해제해야 합니다.

참고

  • ObjectDisposedException 예외: 결과가 해제되었습니다.
  • PdcommException 예외: index가 GemEnhancedCommandResultInfo.ParameterCount보다 작지 않으면 PdcommStatus.OutOfRange, 결과가 S2F49 요청이 아니면 PdcommStatus.InvalidState이거나, 그 밖의 네이티브 실패 상태입니다.

GetEventInfo

메서드

호스트가 받은 이벤트 보고서(S6F11)의 헤더 필드를 가져옵니다.

public GemEventInfo GetEventInfo()

이 결과에 대해 GemHost.AcknowledgeEvent가 성공하면 GemEventInfo.Acknowledged가 true가 됩니다.

반환값

DATAID, CEID, 보고서 수, 확인 응답 상태입니다.

참고

  • ObjectDisposedException 예외: 결과가 해제되었습니다.
  • PdcommException 예외: 결과가 호스트가 받은 이벤트 보고서(GemOutcome.EventReceived)가 아니면 PdcommStatus.InvalidState입니다.

GetEventReport

메서드

수신한 이벤트 보고서(S6F11)에 있는 보고서 하나의 보고서 ID와 값 개수를 가져옵니다.

public GemEventReport GetEventReport(nuint reportIndex)

매개변수

이름설명
reportIndex0부터 시작하는 보고서 위치이며 GemEventInfo.ReportCount보다 작아야 합니다.

반환값

보고서 ID(RPTID)와 보고서의 값 개수입니다.

참고

  • ObjectDisposedException 예외: 결과가 해제되었습니다.
  • PdcommException 예외: 네이티브 호출이 실패했습니다. 결과가 수신한 이벤트 보고서가 아니면 PdcommStatus.InvalidState, reportIndex가 범위를 벗어나면 PdcommStatus.OutOfRange, 보고서 항목의 형식이 잘못되었으면 PdcommStatus.InvalidData입니다.

GetEventValue

메서드

수신한 이벤트 보고서(S6F11)의 보고서에서 변수 값(V) 하나의 복사본을 가져옵니다.

public SecsItem GetEventValue(nuint reportIndex, nuint valueIndex)

이벤트 값에는 VID가 없습니다. 각 위치는 호스트가 S2F33으로 보낸 보고서 정의를 사용해 VID에 대응시킵니다. 반환된 아이템은 결과와 끝점에 독립적이며, 둘 다 해제된 뒤에도 유효합니다.

매개변수

이름설명
reportIndex0부터 시작하는 보고서 위치이며 GemEventInfo.ReportCount보다 작아야 합니다.
valueIndex0부터 시작하는 값 위치이며 GemEventReport.ValueCount보다 작아야 합니다.

반환값

호출자가 소유하며 해제해야 하는 새 아이템입니다.

참고

  • ObjectDisposedException 예외: 결과가 해제되었습니다.
  • PdcommException 예외: 네이티브 호출이 실패했습니다. 결과가 수신한 이벤트 보고서가 아니면 PdcommStatus.InvalidState이고, 인덱스가 범위를 벗어나면 PdcommStatus.OutOfRange입니다.

GetFormattedProgramCapabilityCommandCode

메서드

프로세스 기능 데이터에 있는 명령 하나의 명령 코드(CCODE)를 가져옵니다.

public string GetFormattedProgramCapabilityCommandCode(nuint index)

데이터는 호스트의 S7F22 결과와, GemFormattedPrograms.RespondCapabilityQuery로 응답한 뒤의 장비 S7F21 결과에서 사용할 수 있습니다.

매개변수

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

반환값

ASCII 명령 코드입니다.

참고

  • NotSupportedException 예외: 로드된 네이티브 라이브러리가 정형 프로세스 프로그램 결과 접근자를 내보내지 않습니다.
  • ObjectDisposedException 예외: 결과가 해제되었습니다.
  • PdcommException 예외: 네이티브 접근자가 실패했습니다. 예를 들어 결과에 이 정형 프로세스 프로그램 데이터가 없으면 PdcommStatus.InvalidState이고, 인덱스가 끝을 넘었거나 해당 인덱스의 항목이 없으면 PdcommStatus.OutOfRange입니다.

GetFormattedProgramCapabilityCommandInfo

메서드

프로세스 기능 데이터의 명령 하나에 대한 설명을 가져옵니다.

public GemFormattedProgramCapabilityCommandInfo GetFormattedProgramCapabilityCommandInfo(nuint index)

데이터는 호스트의 S7F22 결과와, GemFormattedPrograms.RespondCapabilityQuery로 응답한 뒤의 장비 S7F21 결과에서 사용할 수 있습니다.

매개변수

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

반환값

명령의 RQCMD, BLKDEF, ACDS 값과 종속성 수 및 매개변수 수입니다.

참고

  • NotSupportedException 예외: 로드된 네이티브 라이브러리가 정형 프로세스 프로그램 결과 접근자를 내보내지 않습니다.
  • ObjectDisposedException 예외: 결과가 해제되었습니다.
  • PdcommException 예외: 네이티브 접근자가 실패했습니다. 예를 들어 결과에 이 정형 프로세스 프로그램 데이터가 없으면 PdcommStatus.InvalidState이고, 인덱스가 끝을 넘었거나 해당 인덱스의 항목이 없으면 PdcommStatus.OutOfRange입니다.

GetFormattedProgramCapabilityCommandName

메서드

프로세스 기능 데이터에 있는 명령 하나의 명령 이름(CNAME)을 가져옵니다.

public string GetFormattedProgramCapabilityCommandName(nuint index)

데이터는 호스트의 S7F22 결과와, GemFormattedPrograms.RespondCapabilityQuery로 응답한 뒤의 장비 S7F21 결과에서 사용할 수 있습니다.

매개변수

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

반환값

최대 16자의 ASCII 명령 이름입니다.

참고

  • NotSupportedException 예외: 로드된 네이티브 라이브러리가 정형 프로세스 프로그램 결과 접근자를 내보내지 않습니다.
  • ObjectDisposedException 예외: 결과가 해제되었습니다.
  • PdcommException 예외: 네이티브 접근자가 실패했습니다. 예를 들어 결과에 이 정형 프로세스 프로그램 데이터가 없으면 PdcommStatus.InvalidState이고, 인덱스가 끝을 넘었거나 해당 인덱스의 항목이 없으면 PdcommStatus.OutOfRange입니다.

GetFormattedProgramCapabilityDependencyAt

메서드

프로세스 기능 데이터에 있는 명령 하나의 종속성 목록에서 값 하나를 가져옵니다.

public ushort GetFormattedProgramCapabilityDependencyAt(nuint command_index, uint field, nuint dependency_index)

데이터는 호스트의 S7F22 결과와, GemFormattedPrograms.RespondCapabilityQuery로 응답한 뒤의 장비 S7F21 결과에서 사용할 수 있습니다.

매개변수

이름설명
command_index0부터 시작하는 명령 인덱스이며 GemFormattedProgramCapabilityInfo.CommandCount보다 작아야 합니다.
field종속성 목록이며 GemFormattedProgramDependency 값입니다. 1은 BCDS, 2는 IBCDS, 3은 NBCDS, 4는 IACDS, 5는 NACDS입니다. 다른 값은 PdcommStatus.InvalidArgument로 실패합니다. 단일 ACDS 값은 GemFormattedProgramCapabilityCommandInfo.AfterDependency입니다.
dependency_index0부터 시작하는 값 인덱스이며 GemFormattedProgramCapabilityCommandInfo의 해당 개수보다 작아야 합니다.

반환값

U2 종속성 값입니다.

참고

  • NotSupportedException 예외: 로드된 네이티브 라이브러리가 정형 프로세스 프로그램 결과 접근자를 내보내지 않습니다.
  • ObjectDisposedException 예외: 결과가 해제되었습니다.
  • PdcommException 예외: 네이티브 접근자가 실패했습니다. 예를 들어 결과에 이 정형 프로세스 프로그램 데이터가 없으면 PdcommStatus.InvalidState이고, 인덱스가 끝을 넘었거나 해당 인덱스의 항목이 없으면 PdcommStatus.OutOfRange입니다.

GetFormattedProgramCapabilityInfo

메서드

이 결과의 S7F21/S7F22 프로세스 기능 정보를 가져옵니다.

public GemFormattedProgramCapabilityInfo GetFormattedProgramCapabilityInfo()

반환값

거래 상태와 기능 데이터의 CMDMAX, BYTMAX, 명령 수입니다.

참고

  • NotSupportedException 예외: 로드된 네이티브 라이브러리가 정형 프로세스 프로그램 결과 접근자를 내보내지 않습니다.
  • ObjectDisposedException 예외: 결과가 해제되었습니다.
  • PdcommException 예외: 네이티브 접근자가 실패했습니다. 예를 들어 결과에 이 정형 프로세스 프로그램 데이터가 없으면 PdcommStatus.InvalidState입니다.

GetFormattedProgramCapabilityModel

메서드

프로세스 기능 데이터의 장비 모델 유형(MDLN)을 가져옵니다.

public string GetFormattedProgramCapabilityModel()

데이터는 호스트의 S7F22 결과와, GemFormattedPrograms.RespondCapabilityQuery로 응답한 뒤의 장비 S7F21 결과에서 사용할 수 있습니다.

반환값

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

참고

  • NotSupportedException 예외: 로드된 네이티브 라이브러리가 정형 프로세스 프로그램 결과 접근자를 내보내지 않습니다.
  • ObjectDisposedException 예외: 결과가 해제되었습니다.
  • PdcommException 예외: 네이티브 접근자가 실패했습니다. 예를 들어 결과에 이 정형 프로세스 프로그램 데이터가 없으면 PdcommStatus.InvalidState입니다.

GetFormattedProgramCapabilityParameter

메서드

프로세스 기능 데이터에 있는 명령 하나의 매개변수 설명 하나를 가져옵니다.

public SecsItem GetFormattedProgramCapabilityParameter(nuint command_index, nuint parameter_index)

데이터는 호스트의 S7F22 결과와, GemFormattedPrograms.RespondCapabilityQuery로 응답한 뒤의 장비 S7F21 결과에서 사용할 수 있습니다.

매개변수

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

반환값

매개변수를 설명하는, 아이템 4개, 5개 또는 9개로 된 새 리스트 SecsItem입니다. 호출자가 반환된 아이템을 소유하며 해제해야 합니다.

참고

  • NotSupportedException 예외: 로드된 네이티브 라이브러리가 정형 프로세스 프로그램 결과 접근자를 내보내지 않습니다.
  • ObjectDisposedException 예외: 결과가 해제되었습니다.
  • PdcommException 예외: 네이티브 접근자가 실패했습니다. 예를 들어 결과에 이 정형 프로세스 프로그램 데이터가 없으면 PdcommStatus.InvalidState이고, 인덱스가 끝을 넘었거나 해당 인덱스의 항목이 없으면 PdcommStatus.OutOfRange입니다.

GetFormattedProgramCapabilitySoftwareRevision

메서드

프로세스 기능 데이터의 소프트웨어 리비전(SOFTREV)을 가져옵니다.

public string GetFormattedProgramCapabilitySoftwareRevision()

데이터는 호스트의 S7F22 결과와, GemFormattedPrograms.RespondCapabilityQuery로 응답한 뒤의 장비 S7F21 결과에서 사용할 수 있습니다.

반환값

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

참고

  • NotSupportedException 예외: 로드된 네이티브 라이브러리가 정형 프로세스 프로그램 결과 접근자를 내보내지 않습니다.
  • ObjectDisposedException 예외: 결과가 해제되었습니다.
  • PdcommException 예외: 네이티브 접근자가 실패했습니다. 예를 들어 결과에 이 정형 프로세스 프로그램 데이터가 없으면 PdcommStatus.InvalidState입니다.

GetFormattedProgramId

메서드

S7F27 검증 보고서의 프로세스 프로그램 ID(PPID)를 가져옵니다.

public SecsItem GetFormattedProgramId()

보고서는 수신한 S7F27에 대한 호스트 결과와, 준비된 S7F27 보고서를 담은 장비의 검증 협상 결과에서 사용할 수 있습니다.

반환값

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

참고

  • NotSupportedException 예외: 로드된 네이티브 라이브러리가 정형 프로세스 프로그램 결과 접근자를 내보내지 않습니다.
  • ObjectDisposedException 예외: 결과가 해제되었습니다.
  • PdcommException 예외: 네이티브 접근자가 실패했습니다. 예를 들어 결과에 이 정형 프로세스 프로그램 데이터가 없으면 PdcommStatus.InvalidState입니다.

GetFormattedProgramInfo

메서드

이 결과의 S7F27/S7F28 프로세스 프로그램 검증 정보를 가져옵니다.

public GemFormattedProgramInfo GetFormattedProgramInfo()

반환값

거래 상태와 수신한 보고서의 PPID 형식 및 문제 수입니다.

참고

  • NotSupportedException 예외: 로드된 네이티브 라이브러리가 정형 프로세스 프로그램 결과 접근자를 내보내지 않습니다.
  • ObjectDisposedException 예외: 결과가 해제되었습니다.
  • PdcommException 예외: 네이티브 접근자가 실패했습니다. 예를 들어 결과에 이 정형 프로세스 프로그램 데이터가 없으면 PdcommStatus.InvalidState입니다.

GetFormattedProgramIssueAt

메서드

S7F27 검증 보고서의 문제 하나를 가져옵니다.

public GemFormattedProgramIssue GetFormattedProgramIssueAt(nuint index)

보고서는 수신한 S7F27에 대한 호스트 결과와, 준비된 S7F27 보고서를 담은 장비의 검증 협상 결과에서 사용할 수 있습니다. 보고서가 없는 결과는 PdcommStatus.InvalidState가 아니라 PdcommStatus.OutOfRange로 실패합니다.

매개변수

이름설명
index0부터 시작하는 문제 인덱스이며 GemFormattedProgramInfo.IssueCount보다 작아야 합니다.

반환값

문제 코드, 시퀀스 번호(SEQNUM), 텍스트(ERRW7)입니다.

참고

  • NotSupportedException 예외: 로드된 네이티브 라이브러리가 정형 프로세스 프로그램 결과 접근자를 내보내지 않습니다.
  • ObjectDisposedException 예외: 결과가 해제되었습니다.
  • PdcommException 예외: 네이티브 접근자가 실패했습니다. 예를 들어 결과에 이 정형 프로세스 프로그램 데이터가 없으면 PdcommStatus.InvalidState이고, 인덱스가 끝을 넘었거나 해당 인덱스의 항목이 없으면 PdcommStatus.OutOfRange입니다.

GetFormattedProgramQueryCommandCode

메서드

반환된 정형 프로세스 프로그램에 있는 명령 하나의 명령 코드(CCODE)를 가져옵니다.

public SecsItem GetFormattedProgramQueryCommandCode(nuint index)

GemFormattedProgramQueryInfo.Present가 1이면 프로그램을 사용할 수 있습니다. 프로그램이 들어 있는 호스트 S7F26 결과, 또는 장비가 저장된 프로그램으로 응답한 뒤의 장비 S7F25 결과가 해당합니다.

매개변수

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

반환값

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

참고

  • NotSupportedException 예외: 로드된 네이티브 라이브러리가 정형 프로세스 프로그램 결과 접근자를 내보내지 않습니다.
  • ObjectDisposedException 예외: 결과가 해제되었습니다.
  • PdcommException 예외: 네이티브 접근자가 실패했습니다. 예를 들어 결과에 이 정형 프로세스 프로그램 데이터가 없으면 PdcommStatus.InvalidState이고, 인덱스가 끝을 넘었거나 해당 인덱스의 항목이 없으면 PdcommStatus.OutOfRange입니다.

GetFormattedProgramQueryCommandInfo

메서드

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

public GemFormattedProgramCommandInfo GetFormattedProgramQueryCommandInfo(nuint index)

GemFormattedProgramQueryInfo.Present가 1이면 프로그램을 사용할 수 있습니다. 프로그램이 들어 있는 호스트 S7F26 결과, 또는 장비가 저장된 프로그램으로 응답한 뒤의 장비 S7F25 결과가 해당합니다.

매개변수

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

반환값

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

참고

  • NotSupportedException 예외: 로드된 네이티브 라이브러리가 정형 프로세스 프로그램 결과 접근자를 내보내지 않습니다.
  • ObjectDisposedException 예외: 결과가 해제되었습니다.
  • PdcommException 예외: 네이티브 접근자가 실패했습니다. 예를 들어 결과에 이 정형 프로세스 프로그램 데이터가 없으면 PdcommStatus.InvalidState이고, 인덱스가 끝을 넘었거나 해당 인덱스의 항목이 없으면 PdcommStatus.OutOfRange입니다.

GetFormattedProgramQueryId

메서드

S7F25가 요청한 프로세스 프로그램 ID(PPID)를 가져옵니다.

public SecsItem GetFormattedProgramQueryId()

모든 조회 결과에는 프로그램 존재 여부와 관계없이 요청된 PPID가 들어 있습니다.

반환값

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

참고

  • NotSupportedException 예외: 로드된 네이티브 라이브러리가 정형 프로세스 프로그램 결과 접근자를 내보내지 않습니다.
  • ObjectDisposedException 예외: 결과가 해제되었습니다.
  • PdcommException 예외: 네이티브 접근자가 실패했습니다. 예를 들어 결과에 이 정형 프로세스 프로그램 데이터가 없으면 PdcommStatus.InvalidState입니다.

GetFormattedProgramQueryInfo

메서드

이 결과의 S7F25/S7F26 정형 프로세스 프로그램 요청 정보를 가져옵니다.

public GemFormattedProgramQueryInfo GetFormattedProgramQueryInfo()

반환값

거래 상태, 요청된 PPID의 형식, 프로그램이 있는지 여부입니다.

참고

  • NotSupportedException 예외: 로드된 네이티브 라이브러리가 정형 프로세스 프로그램 결과 접근자를 내보내지 않습니다.
  • ObjectDisposedException 예외: 결과가 해제되었습니다.
  • PdcommException 예외: 네이티브 접근자가 실패했습니다. 예를 들어 결과에 이 정형 프로세스 프로그램 데이터가 없으면 PdcommStatus.InvalidState입니다.

GetFormattedProgramQueryModel

메서드

반환된 정형 프로세스 프로그램의 장비 모델 유형(MDLN)을 가져옵니다.

public string GetFormattedProgramQueryModel()

GemFormattedProgramQueryInfo.Present가 1이면 프로그램을 사용할 수 있습니다. 프로그램이 들어 있는 호스트 S7F26 결과, 또는 장비가 저장된 프로그램으로 응답한 뒤의 장비 S7F25 결과가 해당합니다.

반환값

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

참고

  • NotSupportedException 예외: 로드된 네이티브 라이브러리가 정형 프로세스 프로그램 결과 접근자를 내보내지 않습니다.
  • ObjectDisposedException 예외: 결과가 해제되었습니다.
  • PdcommException 예외: 네이티브 접근자가 실패했습니다. 예를 들어 결과에 이 정형 프로세스 프로그램 데이터가 없으면 PdcommStatus.InvalidState입니다.

GetFormattedProgramQueryParameter

메서드

반환된 정형 프로세스 프로그램에 있는 명령 하나의 매개변수(PPARM) 하나를 가져옵니다.

public SecsItem GetFormattedProgramQueryParameter(nuint command_index, nuint parameter_index)

GemFormattedProgramQueryInfo.Present가 1이면 프로그램을 사용할 수 있습니다. 프로그램이 들어 있는 호스트 S7F26 결과, 또는 장비가 저장된 프로그램으로 응답한 뒤의 장비 S7F25 결과가 해당합니다.

매개변수

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

반환값

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

참고

  • NotSupportedException 예외: 로드된 네이티브 라이브러리가 정형 프로세스 프로그램 결과 접근자를 내보내지 않습니다.
  • ObjectDisposedException 예외: 결과가 해제되었습니다.
  • PdcommException 예외: 네이티브 접근자가 실패했습니다. 예를 들어 결과에 이 정형 프로세스 프로그램 데이터가 없으면 PdcommStatus.InvalidState이고, 인덱스가 끝을 넘었거나 해당 인덱스의 항목이 없으면 PdcommStatus.OutOfRange입니다.

GetFormattedProgramQuerySoftwareRevision

메서드

반환된 정형 프로세스 프로그램의 소프트웨어 리비전(SOFTREV)을 가져옵니다.

public string GetFormattedProgramQuerySoftwareRevision()

GemFormattedProgramQueryInfo.Present가 1이면 프로그램을 사용할 수 있습니다. 프로그램이 들어 있는 호스트 S7F26 결과, 또는 장비가 저장된 프로그램으로 응답한 뒤의 장비 S7F25 결과가 해당합니다.

반환값

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

참고

  • NotSupportedException 예외: 로드된 네이티브 라이브러리가 정형 프로세스 프로그램 결과 접근자를 내보내지 않습니다.
  • ObjectDisposedException 예외: 결과가 해제되었습니다.
  • PdcommException 예외: 네이티브 접근자가 실패했습니다. 예를 들어 결과에 이 정형 프로세스 프로그램 데이터가 없으면 PdcommStatus.InvalidState입니다.

GetFormattedProgramTransferCommandCode

메서드

수신한 정형 프로세스 프로그램에 있는 명령 하나의 명령 코드(CCODE)를 가져옵니다.

public SecsItem GetFormattedProgramTransferCommandCode(nuint index)

수신한 S7F23에 대한 장비 결과에만 프로그램이 들어 있으며, S7F24 결과에는 들어 있지 않습니다.

매개변수

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

반환값

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

참고

  • NotSupportedException 예외: 로드된 네이티브 라이브러리가 정형 프로세스 프로그램 결과 접근자를 내보내지 않습니다.
  • ObjectDisposedException 예외: 결과가 해제되었습니다.
  • PdcommException 예외: 네이티브 접근자가 실패했습니다. 예를 들어 결과에 이 정형 프로세스 프로그램 데이터가 없으면 PdcommStatus.InvalidState이고, 인덱스가 끝을 넘었거나 해당 인덱스의 항목이 없으면 PdcommStatus.OutOfRange입니다.

GetFormattedProgramTransferCommandInfo

메서드

수신한 정형 프로세스 프로그램에 있는 명령 하나의 매개변수 수와 명령 코드 형식을 가져옵니다.

public GemFormattedProgramCommandInfo GetFormattedProgramTransferCommandInfo(nuint index)

수신한 S7F23에 대한 장비 결과에만 프로그램이 들어 있으며, S7F24 결과에는 들어 있지 않습니다.

매개변수

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

반환값

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

참고

  • NotSupportedException 예외: 로드된 네이티브 라이브러리가 정형 프로세스 프로그램 결과 접근자를 내보내지 않습니다.
  • ObjectDisposedException 예외: 결과가 해제되었습니다.
  • PdcommException 예외: 네이티브 접근자가 실패했습니다. 예를 들어 결과에 이 정형 프로세스 프로그램 데이터가 없으면 PdcommStatus.InvalidState이고, 인덱스가 끝을 넘었거나 해당 인덱스의 항목이 없으면 PdcommStatus.OutOfRange입니다.

GetFormattedProgramTransferId

메서드

수신한 정형 프로세스 프로그램의 프로세스 프로그램 ID(PPID)를 가져옵니다.

public SecsItem GetFormattedProgramTransferId()

수신한 S7F23에 대한 장비 결과에만 프로그램이 들어 있으며, S7F24 결과에는 들어 있지 않습니다.

반환값

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

참고

  • NotSupportedException 예외: 로드된 네이티브 라이브러리가 정형 프로세스 프로그램 결과 접근자를 내보내지 않습니다.
  • ObjectDisposedException 예외: 결과가 해제되었습니다.
  • PdcommException 예외: 네이티브 접근자가 실패했습니다. 예를 들어 결과에 이 정형 프로세스 프로그램 데이터가 없으면 PdcommStatus.InvalidState입니다.

GetFormattedProgramTransferInfo

메서드

이 결과의 S7F23/S7F24 정형 프로세스 프로그램 송신 정보를 가져옵니다.

public GemFormattedProgramTransferInfo GetFormattedProgramTransferInfo()

반환값

거래 상태, ACKC7 코드, 수신한 프로그램의 PPID 형식과 명령 수입니다.

참고

  • NotSupportedException 예외: 로드된 네이티브 라이브러리가 정형 프로세스 프로그램 결과 접근자를 내보내지 않습니다.
  • ObjectDisposedException 예외: 결과가 해제되었습니다.
  • PdcommException 예외: 네이티브 접근자가 실패했습니다. 예를 들어 결과에 이 정형 프로세스 프로그램 데이터가 없으면 PdcommStatus.InvalidState입니다.

GetFormattedProgramTransferModel

메서드

수신한 정형 프로세스 프로그램의 장비 모델 유형(MDLN)을 가져옵니다.

public string GetFormattedProgramTransferModel()

수신한 S7F23에 대한 장비 결과에만 프로그램이 들어 있으며, S7F24 결과에는 들어 있지 않습니다.

반환값

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

참고

  • NotSupportedException 예외: 로드된 네이티브 라이브러리가 정형 프로세스 프로그램 결과 접근자를 내보내지 않습니다.
  • ObjectDisposedException 예외: 결과가 해제되었습니다.
  • PdcommException 예외: 네이티브 접근자가 실패했습니다. 예를 들어 결과에 이 정형 프로세스 프로그램 데이터가 없으면 PdcommStatus.InvalidState입니다.

GetFormattedProgramTransferParameter

메서드

수신한 정형 프로세스 프로그램에 있는 명령 하나의 매개변수(PPARM) 하나를 가져옵니다.

public SecsItem GetFormattedProgramTransferParameter(nuint command_index, nuint parameter_index)

수신한 S7F23에 대한 장비 결과에만 프로그램이 들어 있으며, S7F24 결과에는 들어 있지 않습니다.

매개변수

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

반환값

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

참고

  • NotSupportedException 예외: 로드된 네이티브 라이브러리가 정형 프로세스 프로그램 결과 접근자를 내보내지 않습니다.
  • ObjectDisposedException 예외: 결과가 해제되었습니다.
  • PdcommException 예외: 네이티브 접근자가 실패했습니다. 예를 들어 결과에 이 정형 프로세스 프로그램 데이터가 없으면 PdcommStatus.InvalidState이고, 인덱스가 끝을 넘었거나 해당 인덱스의 항목이 없으면 PdcommStatus.OutOfRange입니다.

GetFormattedProgramTransferSoftwareRevision

메서드

수신한 정형 프로세스 프로그램의 소프트웨어 리비전(SOFTREV)을 가져옵니다.

public string GetFormattedProgramTransferSoftwareRevision()

수신한 S7F23에 대한 장비 결과에만 프로그램이 들어 있으며, S7F24 결과에는 들어 있지 않습니다.

반환값

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

참고

  • NotSupportedException 예외: 로드된 네이티브 라이브러리가 정형 프로세스 프로그램 결과 접근자를 내보내지 않습니다.
  • ObjectDisposedException 예외: 결과가 해제되었습니다.
  • PdcommException 예외: 네이티브 접근자가 실패했습니다. 예를 들어 결과에 이 정형 프로세스 프로그램 데이터가 없으면 PdcommStatus.InvalidState입니다.

GetFormattedProgramVerificationNegotiationInfo

메서드

이 결과의 S7F29/S7F30 프로세스 프로그램 검증 협상 정보를 가져옵니다.

public GemFormattedProgramVerificationNegotiationInfo GetFormattedProgramVerificationNegotiationInfo()

준비된 S7F27 보고서의 PPID와 문제는 GemResult.GetFormattedProgramId와 GemResult.GetFormattedProgramIssueAt으로 읽습니다.

반환값

협상 상태, 종료 결과, PPGNT 코드, 상관 값입니다.

참고

  • NotSupportedException 예외: 로드된 네이티브 라이브러리가 정형 프로세스 프로그램 결과 접근자를 내보내지 않습니다.
  • ObjectDisposedException 예외: 결과가 해제되었습니다.
  • PdcommException 예외: 네이티브 접근자가 실패했습니다. 예를 들어 결과에 이 정형 프로세스 프로그램 데이터가 없으면 PdcommStatus.InvalidState입니다.

GetFormattedProgramVerificationRequestCommandCode

메서드

수신한 정형 프로세스 프로그램에 있는 명령 하나의 명령 코드(CCODE)를 가져옵니다.

public SecsItem GetFormattedProgramVerificationRequestCommandCode(nuint index)

수신한 S7F31에 대한 장비 결과에만 프로그램이 들어 있으며, S7F32 결과에는 들어 있지 않습니다.

매개변수

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

반환값

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

참고

  • NotSupportedException 예외: 로드된 네이티브 라이브러리가 정형 프로세스 프로그램 결과 접근자를 내보내지 않습니다.
  • ObjectDisposedException 예외: 결과가 해제되었습니다.
  • PdcommException 예외: 네이티브 접근자가 실패했습니다. 예를 들어 결과에 이 정형 프로세스 프로그램 데이터가 없으면 PdcommStatus.InvalidState이고, 인덱스가 끝을 넘었거나 해당 인덱스의 항목이 없으면 PdcommStatus.OutOfRange입니다.

GetFormattedProgramVerificationRequestCommandInfo

메서드

수신한 정형 프로세스 프로그램에 있는 명령 하나의 매개변수 수와 명령 코드 형식을 가져옵니다.

public GemFormattedProgramCommandInfo GetFormattedProgramVerificationRequestCommandInfo(nuint index)

수신한 S7F31에 대한 장비 결과에만 프로그램이 들어 있으며, S7F32 결과에는 들어 있지 않습니다.

매개변수

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

반환값

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

참고

  • NotSupportedException 예외: 로드된 네이티브 라이브러리가 정형 프로세스 프로그램 결과 접근자를 내보내지 않습니다.
  • ObjectDisposedException 예외: 결과가 해제되었습니다.
  • PdcommException 예외: 네이티브 접근자가 실패했습니다. 예를 들어 결과에 이 정형 프로세스 프로그램 데이터가 없으면 PdcommStatus.InvalidState이고, 인덱스가 끝을 넘었거나 해당 인덱스의 항목이 없으면 PdcommStatus.OutOfRange입니다.

GetFormattedProgramVerificationRequestId

메서드

수신한 정형 프로세스 프로그램의 프로세스 프로그램 ID(PPID)를 가져옵니다.

public SecsItem GetFormattedProgramVerificationRequestId()

수신한 S7F31에 대한 장비 결과에만 프로그램이 들어 있으며, S7F32 결과에는 들어 있지 않습니다.

반환값

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

참고

  • NotSupportedException 예외: 로드된 네이티브 라이브러리가 정형 프로세스 프로그램 결과 접근자를 내보내지 않습니다.
  • ObjectDisposedException 예외: 결과가 해제되었습니다.
  • PdcommException 예외: 네이티브 접근자가 실패했습니다. 예를 들어 결과에 이 정형 프로세스 프로그램 데이터가 없으면 PdcommStatus.InvalidState입니다.

GetFormattedProgramVerificationRequestInfo

메서드

이 결과의 S7F31/S7F32 검증 요청 정보를 가져옵니다.

public GemFormattedProgramVerificationRequestInfo GetFormattedProgramVerificationRequestInfo()

반환값

거래 상태, ACKC7 코드, 수신한 프로그램의 PPID 형식과 명령 수입니다.

참고

  • NotSupportedException 예외: 로드된 네이티브 라이브러리가 정형 프로세스 프로그램 결과 접근자를 내보내지 않습니다.
  • ObjectDisposedException 예외: 결과가 해제되었습니다.
  • PdcommException 예외: 네이티브 접근자가 실패했습니다. 예를 들어 결과에 이 정형 프로세스 프로그램 데이터가 없으면 PdcommStatus.InvalidState입니다.

GetFormattedProgramVerificationRequestModel

메서드

수신한 정형 프로세스 프로그램의 장비 모델 유형(MDLN)을 가져옵니다.

public string GetFormattedProgramVerificationRequestModel()

수신한 S7F31에 대한 장비 결과에만 프로그램이 들어 있으며, S7F32 결과에는 들어 있지 않습니다.

반환값

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

참고

  • NotSupportedException 예외: 로드된 네이티브 라이브러리가 정형 프로세스 프로그램 결과 접근자를 내보내지 않습니다.
  • ObjectDisposedException 예외: 결과가 해제되었습니다.
  • PdcommException 예외: 네이티브 접근자가 실패했습니다. 예를 들어 결과에 이 정형 프로세스 프로그램 데이터가 없으면 PdcommStatus.InvalidState입니다.

GetFormattedProgramVerificationRequestParameter

메서드

수신한 정형 프로세스 프로그램에 있는 명령 하나의 매개변수(PPARM) 하나를 가져옵니다.

public SecsItem GetFormattedProgramVerificationRequestParameter(nuint command_index, nuint parameter_index)

수신한 S7F31에 대한 장비 결과에만 프로그램이 들어 있으며, S7F32 결과에는 들어 있지 않습니다.

매개변수

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

반환값

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

참고

  • NotSupportedException 예외: 로드된 네이티브 라이브러리가 정형 프로세스 프로그램 결과 접근자를 내보내지 않습니다.
  • ObjectDisposedException 예외: 결과가 해제되었습니다.
  • PdcommException 예외: 네이티브 접근자가 실패했습니다. 예를 들어 결과에 이 정형 프로세스 프로그램 데이터가 없으면 PdcommStatus.InvalidState이고, 인덱스가 끝을 넘었거나 해당 인덱스의 항목이 없으면 PdcommStatus.OutOfRange입니다.

GetFormattedProgramVerificationRequestSoftwareRevision

메서드

수신한 정형 프로세스 프로그램의 소프트웨어 리비전(SOFTREV)을 가져옵니다.

public string GetFormattedProgramVerificationRequestSoftwareRevision()

수신한 S7F31에 대한 장비 결과에만 프로그램이 들어 있으며, S7F32 결과에는 들어 있지 않습니다.

반환값

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

참고

  • NotSupportedException 예외: 로드된 네이티브 라이브러리가 정형 프로세스 프로그램 결과 접근자를 내보내지 않습니다.
  • ObjectDisposedException 예외: 결과가 해제되었습니다.
  • PdcommException 예외: 네이티브 접근자가 실패했습니다. 예를 들어 결과에 이 정형 프로세스 프로그램 데이터가 없으면 PdcommStatus.InvalidState입니다.

GetInfo

메서드

결과의 요약을 가져옵니다. 종류, 결과값, 거래, 코드, 토큰, GEM 상태가 포함됩니다.

public GemResultInfo GetInfo()

반환값

결과 요약입니다.

참고

  • ObjectDisposedException 예외: 결과가 해제되었습니다.
  • PdcommException 예외: 네이티브 호출이 실패했습니다.

GetProgramBody

메서드

수신한 S7F3 요청 또는 S7F6 응답의 PPBODY 복사본을 가져옵니다.

public SecsItem? GetProgramBody()

반환값

호출자가 소유하며 해제해야 하는 새 아이템이거나, S7F6 응답이 알 수 없는 프로그램을 보고하면 null입니다.

참고

  • ObjectDisposedException 예외: 결과가 해제되었습니다.
  • PdcommException 예외: 결과가 S7F3 요청이나 S7F6 응답이 아니면 PdcommStatus.InvalidState입니다.

GetProgramId

메서드

프로세스 프로그램 결과의 PPID 복사본을 가져옵니다.

public SecsItem GetProgramId(nuint index)

매개변수

이름설명
index0부터 시작하는 PPID 인덱스이며 GemProgramInfo.IdCount보다 작아야 합니다.

반환값

호출자가 소유하며 해제해야 하는 새 아이템입니다.

참고

  • ObjectDisposedException 예외: 결과가 해제되었습니다.
  • InvalidOperationException 예외: 네이티브 라이브러리가 아이템을 반환하지 않았습니다.
  • PdcommException 예외: 결과가 프로세스 프로그램 결과가 아니면 PdcommStatus.InvalidState이고, index가 너무 크면 PdcommStatus.OutOfRange입니다.

GetProgramInfo

메서드

수신한 스트림 7 프로세스 프로그램 요청 또는 응답의 상태를 가져옵니다.

public GemProgramInfo GetProgramInfo()

값은 호출 시점의 결과를 반영하며, GemEquipment.RespondProgram 또는 GemEquipment.ConfirmProgramReply 후에 바뀝니다.

반환값

거래, PPID 수, 확인 코드, 로컬 설치 상태와 응답 상태입니다.

참고

  • ObjectDisposedException 예외: 결과가 해제되었습니다.
  • PdcommException 예외: 결과가 프로세스 프로그램 요청이나 응답이 아니면 PdcommStatus.InvalidState입니다.

GetProgramItem

메서드

프로세스 프로그램 결과의 PPID 또는 PPBODY 복사본을 가져옵니다.

public SecsItem? GetProgramItem(GemProgramField field, nuint index = 0)

PPID는 S7F1, S7F3, S7F5, S7F17 요청과 S7F6, S7F20 응답에서 사용할 수 있습니다. 본문은 S7F3 요청과 S7F6 응답에서 사용할 수 있습니다.

매개변수

이름설명
field읽을 필드입니다.
indexGemProgramField.Id이면 0부터 시작하는 PPID 인덱스이며 GemProgramInfo.IdCount보다 작아야 합니다. GemProgramField.Body이면 0입니다.

반환값

호출자가 소유하며 해제해야 하는 새 아이템이거나, 알 수 없는 프로그램을 보고하는 S7F6 응답의 본문이면 null입니다. 저장된 빈 본문은 빈 아이템으로 반환됩니다.

참고

  • ArgumentOutOfRangeException 예외: field가 정의된 값이 아닙니다.
  • ObjectDisposedException 예외: 결과가 해제되었습니다.
  • PdcommException 예외: 결과가 프로세스 프로그램 결과가 아니거나 해당 필드가 없으면 PdcommStatus.InvalidState이고, index가 너무 크면 PdcommStatus.OutOfRange입니다.

GetQueryInfo

메서드

수신한 조회 또는 조회 응답의 보고서 조회 세부 정보를 가져옵니다.

public GemQueryInfo GetQueryInfo()

반환값

조회 세부 정보입니다. 장비가 받은 조회이면 종류, ID, GemQueryInfo.IsRequest, GemQueryInfo.Responded만 설정됩니다.

참고

  • ObjectDisposedException 예외: 결과가 해제되었습니다.
  • PdcommException 예외: 결과가 수신한 조회나 유효한 조회 응답이 아니면(예: 실패했거나, 형식이 잘못되었거나, 중단되었거나, 관련 없는 결과) PdcommStatus.InvalidState입니다.

GetQueryReport

메서드

S6F16 이벤트 보고서 응답의 보고서 하나를 가져옵니다.

public GemQueryReportInfo GetQueryReport(nuint reportIndex)

매개변수

이름설명
reportIndex0부터 시작하는 보고서 인덱스이며 GemQueryInfo.ReportCount보다 작아야 합니다.

반환값

응답에 담긴 순서대로의 보고서 ID(RPTID)와 값 개수입니다.

참고

  • ObjectDisposedException 예외: 결과가 해제되었습니다.
  • PdcommException 예외: 결과가 S6F16 응답이 아니면 PdcommStatus.InvalidState이고, 인덱스가 잘못되었으면 PdcommStatus.OutOfRange입니다.

GetQueryValue

메서드

보고서 조회 응답의 값 하나를 가져옵니다.

public GemQueryValue GetQueryValue(nuint reportIndex, nuint valueIndex)

매개변수

이름설명
reportIndexS6F16 응답이면 0부터 시작하는 보고서 인덱스이고, S6F20과 S6F22 응답이면 0이어야 합니다.
valueIndex보고서 또는 응답 안에서 0부터 시작하는 값 인덱스입니다.

반환값

호출자가 소유하며 해제해야 하는 새 값입니다. S6F22 값에만 변수 ID(VID)가 들어 있으며, 중복 VID는 전송 순서를 유지합니다.

참고

  • ObjectDisposedException 예외: 결과가 해제되었습니다.
  • PdcommException 예외: 결과가 조회 응답이 아니면 PdcommStatus.InvalidState이고, 인덱스가 잘못되었으면 PdcommStatus.OutOfRange입니다.

GetSpoolError

메서드

호스트가 받은 S2F44의 스트림 오류 하나를 가져옵니다.

public GemSpoolResultError GetSpoolError(nuint index)

RSPACK 0인 S2F44에는 오류가 없습니다.

매개변수

이름설명
index0부터 시작하는 위치이며 GemSpoolInfo.ErrorCount보다 작아야 합니다.

반환값

호출자가 소유하며 해제해야 하는 새 오류입니다. 결과를 해제한 뒤에도 유효합니다.

참고

  • ObjectDisposedException 예외: 결과가 해제되었습니다.
  • PdcommException 예외: 결과가 호스트가 받은 S2F44가 아니면 PdcommStatus.InvalidState, index가 너무 크면 PdcommStatus.OutOfRange, 본문을 구문 분석할 수 없으면 PdcommStatus.InvalidData이거나, PdcommStatus.AllocationFailed 같은 그 밖의 네이티브 실패입니다.
  • InvalidOperationException 예외: 네이티브 라이브러리가 펑션 목록을 반환하지 않았습니다.

GetSpoolInfo

메서드

스풀링 요청, 응답 또는 전달 결과의 스풀링 세부 정보를 가져옵니다.

public GemSpoolInfo GetSpoolInfo()

스풀링 결과의 결과값은 GemOutcome.SpoolReceived, GemOutcome.SpoolConfigurationAck, GemOutcome.SpoolConfigurationData, GemOutcome.SpoolControlAck, GemOutcome.SpoolDeliveryResponse, GemOutcome.SpoolDeliveryWritten 또는 GemOutcome.SpoolDeliveryFailed입니다.

반환값

이 결과에 대한 마지막 작업 시점의 스풀링 세부 정보입니다.

참고

  • ObjectDisposedException 예외: 결과가 해제되었습니다.
  • PdcommException 예외: 결과가 스풀링 결과가 아니면 PdcommStatus.InvalidState입니다.

GetSpoolSelection

메서드

장비가 받은 S2F43 또는 호스트가 받은 S2F60의 스트림 선택 하나를 가져옵니다.

public GemSpoolResultSelection GetSpoolSelection(nuint index)

매개변수

이름설명
index0부터 시작하는 위치이며 GemSpoolInfo.SelectionCount보다 작아야 합니다.

반환값

호출자가 소유하며 해제해야 하는 새 선택입니다. 결과를 해제한 뒤에도 유효합니다.

참고

  • ObjectDisposedException 예외: 결과가 해제되었습니다.
  • PdcommException 예외: 결과가 해당 메시지가 아니면 PdcommStatus.InvalidState, index가 너무 크면 PdcommStatus.OutOfRange, 본문을 구문 분석할 수 없으면 PdcommStatus.InvalidData이거나, PdcommStatus.AllocationFailed 같은 그 밖의 네이티브 실패입니다.
  • InvalidOperationException 예외: 네이티브 라이브러리가 펑션 목록을 반환하지 않았습니다.

GetStatusName

메서드

검증된 S1F12 상태 변수 이름 목록의 항목 하나를 가져옵니다.

public GemStatusName GetStatusName(nuint index)

매개변수

이름설명
index0부터 시작하는 항목 인덱스이며 GemResultInfo.EntryCount보다 작아야 합니다.

반환값

상태 변수 ID, 이름, 단위입니다.

참고

  • ObjectDisposedException 예외: 결과가 해제되었습니다.
  • PdcommException 예외: 결과값이 GemOutcome.NamesReceived가 아니면 PdcommStatus.InvalidState이고, 인덱스가 잘못되었으면 PdcommStatus.OutOfRange입니다.
  • InvalidOperationException 예외: 읽는 동안 네이티브 항목 크기가 바뀌었습니다.

GetStatusValue

메서드

검증된 S1F4 응답의 상태 변수 값 하나를 가져옵니다.

public GemStatusValue GetStatusValue(nuint index)

매개변수

이름설명
index0부터 시작하는 항목 인덱스이며 GemResultInfo.EntryCount보다 작아야 합니다.

반환값

호출자가 소유하며 해제해야 하는 새 값입니다. 선택 요청이면 ID는 요청 순서와 일치하고, 전체 값 요청이면 GemStatusValue.Id가 null입니다.

참고

  • ObjectDisposedException 예외: 결과가 해제되었습니다.
  • PdcommException 예외: 결과값이 GemOutcome.ValuesReceived가 아니면 PdcommStatus.InvalidState이고, 인덱스가 잘못되었으면 PdcommStatus.OutOfRange입니다.

TryCopyAlarmAt

메서드

알람 보고 또는 알람 목록의 알람 항목 하나를 호출자가 제공한 버퍼에 복사합니다.

public bool TryCopyAlarmAt(nuint index, out GemAlarmValueInfo info, Span<byte> text, out nuint required)

매개변수

이름설명
index0부터 시작하는 항목 인덱스입니다.
info이 메서드가 반환될 때 알람 ID, 범주, 활성 상태를 담습니다.
text알람 텍스트를 ASCII 바이트로 받는 버퍼입니다. 종결 NUL은 추가하지 않습니다.
required이 메서드가 반환될 때 텍스트 길이(바이트)를 담습니다.

반환값

텍스트를 복사했으면 true이고, text가 required보다 짧으면 false입니다. 이 경우 text는 바뀌지 않으며, info와 required는 여전히 설정됩니다.

참고

  • ObjectDisposedException 예외: 결과가 해제되었습니다.
  • PdcommException 예외: index가 범위를 벗어나면 PdcommStatus.OutOfRange, 결과가 알람 보고나 목록이 아니면 PdcommStatus.InvalidState이거나, 그 밖의 네이티브 실패 상태입니다.

TryCopyStatusName

메서드

검증된 S1F12 상태 변수 이름 목록의 항목 하나를 호출자 버퍼에 복사합니다.

public bool TryCopyStatusName(nuint index, out uint id, Span<byte> name, out nuint nameRequired, Span<byte> units, out nuint unitsRequired)

매개변수

이름설명
index0부터 시작하는 항목 인덱스이며 GemResultInfo.EntryCount보다 작아야 합니다.
id상태 변수 ID(SVID)를 받습니다. 메서드가 false를 반환하면 0입니다.
nameASCII 이름 바이트를 받는 버퍼입니다. 종결자는 추가하지 않습니다.
nameRequired이름 길이(바이트)를 받습니다.
unitsASCII 단위 바이트를 받는 버퍼입니다. 종결자는 추가하지 않습니다.
unitsRequired단위 길이(바이트)를 받습니다.

반환값

두 값을 모두 복사했으면 true이고, 어느 한 버퍼라도 너무 작으면 false입니다. 이 경우 두 버퍼 모두 바뀌지 않으며 필요한 길이가 보고됩니다.

참고

  • ArgumentException 예외: name과 units가 겹칩니다.
  • ObjectDisposedException 예외: 결과가 해제되었습니다.
  • PdcommException 예외: 결과값이 GemOutcome.NamesReceived가 아니면 PdcommStatus.InvalidState이고, 인덱스가 잘못되었으면 PdcommStatus.OutOfRange입니다.

개인정보 처리방침