서비스 개체 개발자를 위한 PosCommon 정보(POS for .NET v1.14 SDK 설명서)

.NET Server 개체 클래스 트리(Interface, Basic, Base)에 대한 POS의 기본값은 다음과 같습니다 PosCommon. 이 클래스는 UPOS 사양의 "공통 속성, 메서드 및 이벤트" 챕터의 직접 구현입니다.

.NET Basic 클래스에 대한 각 POS는 서비스 개체 개발자에게 특히 중요한 PosCommon 속성 및 메서드를 재정의하거나 구현합니다. 이 항목에서는 이러한 메서드 및 속성에 대한 정보를 제공합니다.

CapPowerReporting 속성

.NET용 POS가 디바이스를 성공적으로 열면 속성의 CapPowerReporting 현재 값을 검색하려고 시도합니다. 클래스가 PowerReportingNone으로 초기화되어 서비스 개체가 전원 보고를 제공할 수 없음을 나타냅니다. 그러나 서비스 개체의 디바이스가 전원 보고를 지원하는 경우 서비스 개체는 서비스 개체의 메서드에서 PowerReporting을표준 또는 고급 으로 설정할 수 있습니다.

CapStatisticsReporting 속성

.NET용 POS는 디바이스가 열려 있음을 확인한 다음 속성의 CapStatisticsReporting 현재 값을 검색합니다.

디바이스에 대한 통계가 생성되면 .NET용 POS 는 CapStatisticsReporting을true로 설정합니다.

CapUpdateStatistics 속성

.NET용 POS는 디바이스가 열려 있음을 확인한 다음 속성의 CapUpdateStatistics 현재 값을 검색합니다.

디바이스에 대한 통계가 생성되고 해당 통계를 다시 설정하거나 업데이트할 수 있는 경우 .NET용 POS는 CapUpdateStatistics 를 true로 설정합니다.

청구된 속성

.NET용 POS는 디바이스가 열려 있음을 확인한 다음 속성의 Claimed 현재 값을 검색합니다.

클레임 이 false로 초기화됩니다. 클레임은 애플리케이션이 메서드를 호출 할 때 Claim(Int32)로 설정한 다음 애플리케이션이 메서드를 호출 할 때 Release()로 다시 설정해야 합니다.

DeviceDescription 속성

.NET용 POS는 디바이스가 열려 있음을 확인한 다음 속성의 DeviceDescription 현재 값을 검색합니다.

DeviceEnabled 속성

DeviceEnabled 는 읽기/쓰기 속성입니다.

개체의 현재 상태를 반환하는 데 사용할 수 있습니다. 사용하거나 사용하지 않도록 설정합니다. 이 개체를 이전에 열고 사용하도록 설정하지 않은 경우 이 속성은 false를 반환합니다.

이 속성은 값의 속성을 true 또는 false로 설정하여 디바이스를 사용하거나 사용하지 않도록 설정하는 데도 사용됩니다. 서비스 개체는 이 속성을 재정의하고 하드웨어 초기화 및 릴리스를 수행하는 것이 일반적입니다.

DeviceName 속성

.NET용 POS는 디바이스가 열려 있음을 확인한 다음 속성의 DeviceName 현재 값을 검색합니다.

기본 클래스 구현 내에서 이 값은 특성의 ServiceObject 내용에 따라 자동으로 설정됩니다.

.NET 기본 클래스용 POS에서 파생되지 않고 대신 인터페이스 수준 또는 기본 수준 클래스에서 파생되는 경우 메서드 중에 서비스 주체에서 Open()을 설정해야 합니다.

FreezeEvents 속성

FreezeEvents 는 읽기/쓰기 속성입니다.

.NET용 POS는 디바이스가 열리고 클레임되었는지 확인한 다음 FreezeEvents 속성의 현재 값을 검색하거나 설정합니다. 이 속성이 true로 설정되면 .NET용 POS는 이 속성이 false로 설정될 때까지 이벤트를 큐에 넣습니다. 큐 메커니즘은 디바이스 유형마다 다를 수 없습니다.

FreezeEvents 속성이 false로 초기화됩니다.

PowerNotify 속성

PowerNotify 는 읽기/쓰기 속성입니다.

.NET용 POS는 디바이스가 열려 있음을 확인한 다음 PowerNotify의 현재 값을 검색하거나 설정합니다. PowerNotify가 설정되면 전원 상태 알림이 애플리케이션으로 전송됩니다.

PowerNotify 가 사용 안 함으로 초기화됩니다.

PowerNotify를 설정하려고 하면 다음 예외가 발생할 수 있습니다.

값	의미
Illegal	다음 조건 중 하나가 발생했습니다. 디바이스를 사용할 수 있습니다. P:Microsoft.PointOfService.PosCommon.CapPowerReporting이 없음으로 설정되어 디바이스가 전원 알림을 지원하지 않음을 나타냅니다. 지정된 값이 유효한 T:Microsoft.PointOfService.PowerNotification 열거형 값이 아닙니다.

Illegal

다음 조건 중 하나가 발생했습니다.

디바이스를 사용할 수 있습니다.
P:Microsoft.PointOfService.PosCommon.CapPowerReporting이 없음으로 설정되어 디바이스가 전원 알림을 지원하지 않음을 나타냅니다.
지정된 값이 유효한 T:Microsoft.PointOfService.PowerNotification 열거형 값이 아닙니다.

PowerState 속성

.NET용 POS는 디바이스가 열려 있음을 확인한 다음 속성의 PowerState 현재 값을 검색합니다. CapPowerReporting이 None으로 설정되거나 PowerNotify가 Disabled로 설정되거나 DeviceEnabled가 false로 설정된 경우 PowerState는 알 수 없음으로 반환됩니다.

PowerState 가 알 수 없음으로 초기화됩니다. PowerNotify가 Enabled로 설정되고 DeviceEnabled가 true이면 서비스 개체가 전원 조건 변경을 검색할 때 PowerState를 업데이트해야 합니다. .NET용 POS는 서비스 개체가 PowerState 를 설정하고 PowerNotify 가 Enabled로 설정된 경우 애플리케이션에 알리는 이벤트를 큐에 넣으면 상태 변경을 감지합니다 StatusUpdateEvent .

설정 PowerState 으로 인해 다음 예외가 발생할 수 있습니다.

값	의미
Illegal	다음 조건 중 하나가 발생했습니다. CapPowerReporting = 표준 및 PowerNotify 는 온라인, 끄기 또는 오프라인으로 설정됩니다. CapPowerReporting = 고급 및 PowerState 는 온라인, 끄기 또는 오프라인으로 설정됩니다.

Illegal

다음 조건 중 하나가 발생했습니다.

CapPowerReporting = 표준 및 PowerNotify 는 온라인, 끄기 또는 오프라인으로 설정됩니다.
CapPowerReporting = 고급 및 PowerState 는 온라인, 끄기 또는 오프라인으로 설정됩니다.

ServiceObjectDescription 속성

.NET용 POS는 디바이스가 열려 있음을 확인한 다음 속성의 ServiceObjectDescription 현재 값을 검색합니다. 서비스 개체 개발자는 이 값을 설정할 필요가 없습니다. 이 값은 POS for .NET Basic 클래스가 제공된 ServiceObject 특성의 설명 정보를 사용하여 자동으로 설정하기 때문입니다.

ServiceObjectVersion 속성

.NET용 POS는 디바이스가 열려 있음을 확인한 다음 속성의 ServiceObjectVersion 현재 값을 검색합니다. 서비스 개체 개발자는 이 값을 설정할 필요가 없습니다. 이 값은 .NET Basic 클래스용 POS에 의해 특성에서 제공된 버전 정보를 사용하여 자동으로 설정됩니다.

State 속성

디바이스 상태 확인이 필요하지 않습니다. 애플리케이션은 언제든지 State 속성의 현재 값을 검색할 수 있습니다.

상태가Closed로 초기화됩니다. 서비스 개체가 상태를 유효하지 않은 ControlState 값으로 설정할 경우, .NET용 POS에서 불법적인 예외가 발생합니다. 상태가 변경되면 .NET용 POS가 StateChangedEvent 이벤트를 큐에 넣습니다.

클레임 방법

.NET용 POS는 애플리케이션에 디바이스가 열려 있음을 확인합니다.

제한 시간 매개 변수가 -1보다 작은 값으로 설정된 경우 .NET용 POS는 예외를 throw합니다. 시간 제한 값이 -1로 설정된 경우 클레임 메서드는 영원히 대기합니다.

디바이스가 애플리케이션에서 이미 클레임된 경우 .NET용 POS는 단순히 반환됩니다.

디바이스가 다른 애플리케이션에서 사용 중인 경우 시간 제한 에 도달합니다. .NET용 POS는 시간 제한 예외를 throw합니다.

클레임에 성공하면 .NET용 POS는 디바이스에 대한 통계를 로드하고 Claim 속성을 true로 설정합니다.

Close 메서드

애플리케이션이 메서드를 호출할 때 State가 Closed로 설정되어 있으면, .NET용 POS에서 Closed 예외가 발생합니다. 상태가사용 중으로 설정된 경우 .NET용 POS는 사용 중 예외를 throw합니다.

클레임 시 DeviceEnabled 메서드가 false로 설정된 경우 .NET용 POS는 잘못된 예외를 throw합니다. 상태가사용 중으로 설정된 경우 .NET용 POS는 ClearOutput 메서드를 호출합니다. 디바이스를 사용하는 경우 .NET용 POS 는 DeviceEnabled 를 false로 설정합니다. .NET용 POS는 이벤트 큐를 지운 다음 클레임 을 false로 설정합니다.

ResetStatistic 메서드

.NET용 POS는 애플리케이션이 디바이스를 열고, 클레임하고, 사용하도록 설정한 다음, 메서드를 ResetStatistic(String) 호출했는지 확인합니다.

ResetStatistics() 메서드

.NET용 POS는 애플리케이션이 디바이스를 열고, 클레임하고, 사용하도록 설정한 다음, 메서드를 ResetStatistics() 호출했는지 확인합니다.

ResetStatistics(카테고리 매개 변수) 메서드

.NET용 POS는 애플리케이션이 디바이스를 열고, 클레임하고, 사용하도록 설정한 다음, 메서드를 ResetStatistics(StatisticCategories) 호출했는지 확인합니다.

ResetStatistics(문자열 매개 변수) 메서드

.NET용 POS는 애플리케이션이 디바이스를 열고, 클레임하고, 사용하도록 설정한 다음, 메서드를 ResetStatistics(String[]) 호출했는지 확인합니다.

RetrieveStatistic 메서드

.NET용 POS는 애플리케이션이 디바이스를 열고, 클레임하고, 사용하도록 설정한 다음, 메서드를 RetrieveStatistic(String) 호출했는지 확인합니다.

RetrieveStatistics() 메서드

.NET용 POS는 애플리케이션이 디바이스를 열고, 클레임하고, 사용하도록 설정한 다음, 메서드를 RetrieveStatistics() 호출했는지 확인합니다.

RetrieveStatistics(categories 매개 변수) 메서드

.NET용 POS는 애플리케이션이 디바이스를 열고, 클레임하고, 사용하도록 설정한 다음, 메서드를 RetrieveStatistics(StatisticCategories) 호출했는지 확인합니다.

RetrieveStatistics(문자열 매개 변수) 메서드

.NET용 POS는 애플리케이션이 디바이스를 열고, 클레임하고, 사용하도록 설정한 다음, 메서드를 RetrieveStatistics(String[]) 호출했는지 확인합니다.

UpdateStatistic 메서드

.NET용 POS는 애플리케이션이 디바이스를 열고, 클레임하고, 사용하도록 설정한 다음, 메서드를 UpdateStatistic(String, Object) 호출했는지 확인합니다.

UpdateStatistics(categories 매개 변수) 메서드

.NET용 POS는 애플리케이션이 디바이스를 열고, 클레임하고, 사용하도록 설정한 다음, 메서드를 UpdateStatistics(StatisticCategories, Object) 호출했는지 확인합니다.

UpdateStatistics(통계 배열 매개 변수) 메서드

.NET용 POS는 애플리케이션이 디바이스를 열고, 클레임하고, 사용하도록 설정한 다음, 메서드를 UpdateStatistics(Statistic[]) 호출했는지 확인합니다.

또한 참조하십시오

피드백

이 페이지가 도움이 되었나요?

Last updated on 2025-12-02