특정 데이터베이스 연결을 통해 발행 된 명령을 취소하는 데 필요한 정보가 포함 된 데이터 구조를 만듭니다.

pgcancel *pqgetCancel (pgconn *conn);

pqgetCancela 생성pgcancel주어진 대상pgconn연결 객체. 돌아올 것입니다NULL주어진 경우connisnull또는 잘못된 연결. 그만큼pgcancel객체는 응용 프로그램에서 직접 액세스 할 수없는 불투명 구조입니다. 전달 될 수 있습니다pqcancel또는PQFREECANCEL.

|pqgetCancel.

void pqfreecancel (pgcancel *cancel);

PQFREECANCEL이전에 생성 된 데이터 객체를 해제pqgetCancel.

서버가 현재 명령의 처리를 포기하도록 요청합니다.

int pqcancel (pgcancel *취소, char *errbuf, int errbufsize);

취소 요청이 성공적으로 발송 된 경우 반환 값이 1이고 그렇지 않은 경우 0입니다. 그렇지 않다면errbuf설명 오류 메시지로 채워져 있습니다.errbuf크기의 숯불 배열이어야합니다errbufsize(권장 크기는 256 바이트).

성공적인 파견은 요청에 어떤 영향을 미칠 것이라고 보장하지 않습니다. 취소가 효과적이면 현재 명령은 조기에 종료되어 오류 결과를 반환합니다. 취소가 실패하면 (예 : 서버가 이미 명령 처리를 수행했기 때문에) 눈에 띄는 결과는 전혀 없습니다.

pqcancel인 경우 신호 핸들러에서 안전하게 호출 할 수 있습니다errbuf는 신호 핸들러의 로컬 변수입니다. 그만큼pgcancel객체는 읽기 전용으로pqcancel걱정이되므로 조작하는 것과 분리 된 스레드에서도 호출 할 수 있습니다pgconn개체.

PQREQUESTCANCEL|pqcancel.

int pqrequestCancel (pgconn *conn);

서버가 현재 명령의 처리를 포기하도록 요청합니다. 직접 작동합니다.pgconn객체 및 고장의 경우 오류 메시지가에 저장됩니다.pgconn객체 (PQERRORMESSAGE). 기능은 동일하지만이 접근법은 다중 스레드 프로그램이나 신호 처리기 내에서 안전하지 않습니다.pgconn의 오류 메시지는 현재 연결 중에 진행중인 작업이 엉망이됩니다.