pdcomm_license_host_id
함수
이 머신의 호스트 ID를 복사합니다.
PdcommStatus pdcomm_license_host_id(uint8_t *output, size_t capacity, size_t *required)호스트 ID는 PDH1-XXXX-XXXX-XXXX-XXXX 형식(종료 NUL 없는 ASCII 24바이트)입니다. 운영체제의 머신 ID에서 만들며, SECS/GEM 런타임 또는 개발자 라이선스의 호스트 목록에 들어가는 값입니다.
매개변수
| 이름 | 설명 |
|---|---|
output | 호스트 ID를 받을 대상 버퍼입니다. capacity가 0일 때만 NULL일 수 있습니다. |
capacity | output의 크기(바이트)입니다. |
required | 호스트 ID의 길이(24)를 받으며, 호스트 ID를 알 수 없으면 0을 받습니다. NULL이 아니어야 합니다. |
반환값
호스트 ID를 복사하면 #PDCOMM_OK를 반환합니다. capacity가 *required보다 작으면 #PDCOMM_BUFFER_TOO_SMALL을 반환하며 출력은 변경하지 않습니다. required가 NULL이거나, capacity가 0이 아닌데 output이 NULL이면 #PDCOMM_INVALID_ARGUMENT를 반환합니다. /etc/machine-id가 없는 컨테이너처럼 머신 ID를 읽을 수 없으면 #PDCOMM_IO_ERROR를 반환합니다. 패닉(panic)을 격리했으면 #PDCOMM_INTERNAL_ERROR를 반환합니다.
참고
- 스레드 안전성: 어느 스레드에서나 호출할 수 있습니다.