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

pgcancel *pqgetCancel (pgconn *conn);

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

|pqgetCancel.

void pqfreecancel (pgcancel *cancel);

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

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

int pqcancel (pgcancel *cance, 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의 오류 메시지는 현재 연결 중에 진행중인 작업이 엉망이됩니다.