pdcomm_opcua_license_install
함수
이 라이브러리에 PDComm 라이선스 텍스트를 설치합니다.
int32_t pdcomm_opcua_license_install(const uint8_t *text, size_t size)이 함수로 이전에 설치한 텍스트를 교체하고, 다른 라이선스 소스(환경 변수와 pdcomm.license 파일)와 합쳐서 사용합니다. 이 라이브러리의 모든 클라이언트와 서버에 적용되며, SECS/GEM과 Modbus 라이브러리는 각자 따로 설치합니다. 라이선스를 설치해도 기존 클라이언트나 서버는 멈추지 않습니다.
매개변수
| 이름 | 설명 |
|---|---|
text | -----BEGIN PDCOMM LICENSE----- 블록이 하나 이상 들어 있는 UTF-8 텍스트입니다. 블록 밖의 텍스트는 무시합니다. size가 0이면 null일 수 있습니다. |
size | text의 크기(바이트)이며 최대 1 MiB입니다. 0이거나 공백만 있는 텍스트이면 설치한 텍스트를 제거합니다. |
반환값
블록이 하나 이상 검증되었거나(만료되었거나 호스트에 묶인 라이선스도 받아들이며, 상태는 pdcomm_opcua_license_status()가 보고합니다) 텍스트를 제거했으면 #PDCOMM_OPCUA_OK를 반환합니다. 크기가 0이 아닌데 text가 null이거나, 텍스트가 1 MiB를 넘거나 UTF-8이 아니거나, 서명이 검증되는 블록이 없으면 #PDCOMM_OPCUA_INVALID_INPUT을 반환합니다. 이때 이전 텍스트는 그대로 설치되어 있고, 상세 텍스트에 이유가 나옵니다. 그 밖에 #PDCOMM_OPCUA_INTERNAL_ERROR를 반환할 수 있습니다.
참고
- 스레드에 안전합니다. ABI 0.2에서 추가되었습니다.