pdcomm_tcp_local_address
함수
로컬 소켓 주소를 텍스트로 복사합니다.
PdcommStatus pdcomm_tcp_local_address(PdcommTcpEndpoint *endpoint, uint8_t *output, size_t capacity, size_t *required)수동 엔드포인트는 수신 대기 소켓을 가지고 있는 동안, 즉 생성부터 pdcomm_tcp_stop()까지, 그리고 pdcomm_tcp_start() 이후 다시 수신 대기 주소를 보고합니다. 능동 엔드포인트는 현재 연결의 로컬 주소를 보고합니다. 텍스트는 127.0.0.1:5000 또는 [::1]:5000 형식이며, NUL 종료 문자가 없고 80바이트 안에 들어갑니다.
매개변수
| 이름 | 설명 |
|---|---|
endpoint | 유효한 엔드포인트입니다. |
output | 대상 버퍼입니다. 크기 조회를 위해 capacity가 0이면 NULL일 수 있습니다. |
capacity | output의 크기(바이트)입니다. |
required | 텍스트 길이를 받습니다. 먼저 0으로 설정됩니다. NULL이 아니어야 합니다. |
반환값
텍스트를 복사하면 #PDCOMM_OK를 반환합니다. capacity가 *required보다 작으면 #PDCOMM_BUFFER_TOO_SMALL을 반환하며 출력은 변경하지 않습니다. required 또는 endpoint가 NULL이거나, 용량이 충분한데 output이 NULL이면 #PDCOMM_INVALID_ARGUMENT를 반환합니다. 수신 대기 소켓이나 연결이 없거나 운영체제가 주소를 알려 주지 못하면 #PDCOMM_IO_ERROR를 반환합니다. #PDCOMM_POISONED를 반환할 수도 있습니다.