30.12. 롤 토토 시스템

레지스터 롤 토토는 발생합니다PQREGISTEREVENTPROC호출됩니다. 그것은 모든 초기화에 이상적인 시간instanceata롤 토토 절차가 필요할 수 있습니다. 롤 토토 핸들러 당 하나의 레지스터 롤 토토 만 해고됩니다. 연결 당. 롤 토토 절차가 실패하면 등록이 중단되었습니다.

typedef struct

    pgconn *conn;
 pgeventRegister;

apgevt_register롤 토토 접수,evtinfo포인터가 a에 캐스트해야합니다pgeventRegister *. 이 구조 포함pgconnConnection_ok상태; 전화가 보장 보장PQREGISTEREVENTPROC직후 좋은 획득pgconn. 언제 실패 코드를 반환하면 모든 정리가 수행되어야합니다 아니요PGEVT_CONNDESTROY롤 토토 발송됩니다.

연결 재설정 롤 토토는 완료되면pqreset또는pqresetpoll. 두 경우 모두 롤 토토 재설정이 성공한 경우에만 해고됩니다. 롤 토토 인 경우 프로 시저가 실패하면 전체 연결 재설정이 실패합니다. 그만큼pgconnConnection_Bad상태 및pqresetpoll복귀 할 것입니다pgres_polling_failed.

typedef struct

    pgconn *conn;
 pgeventconnreset;

aPGEVT_CONNRESET롤 토토 접수,evtinfo포인터가 a에 캐스트해야합니다pgeventconnreset *. 비록 포함pgconn그냥이었다 재설정, 모든 롤 토토 데이터는 변경되지 않았습니다. 이 행사 관련된 모든 것을 재설정/새로 고침/요청하는 데 사용해야합니다instanceata. 더라도 롤 토토 절차가 처리되지 않습니다PGEVT_CONNRESET, 여전히 a를받을 것입니다.PGEVT_CONNDESTROY연결이 닫혔습니다.

연결 파괴 롤 토토가 해고되어pqfinish. 롤 토토입니다 롤 토토를 올바르게 정리하는 절차의 책임 LIBPQ로서의 데이터는이 메모리를 관리 할 능력이 없습니다. 정리하지 않으면 메모리 누출이 발생합니다.

typedef struct

    pgconn *conn;
 pgeventconndestroy;

언제pgevt_conndestroy롤 토토가 접수되었습니다.evtinfo포인터가 a에 캐스트해야합니다pgeventconndestroy *. 이 이벤트입니다 이전에 해고pqfinish다른 정리 수행. 의 반환 값 방법이 없기 때문에 롤 토토 절차는 무시됩니다. 실패를 나타내는pqfinish. 또한 롤 토토 절차 실패는 청소 과정을 중단해서는 안됩니다 원치 않는 기억.

결과 생성 롤 토토는 어떤 것에 대응하여 해고됩니다. 결과를 생성하는 쿼리 실행 기능 포함pqgetresult. 이것 결과는 결과가 발생한 후에 만 해고됩니다. 성공적으로 만들어졌습니다.

typedef struct

    pgconn *conn;
    pgresult *결과;
 pgeventresultcreate;

apgevt_resultcreate롤 토토가 접수되었습니다.evtinfo포인터가 a에 캐스트해야합니다pgeventresultcreate *. 그만큼conn생성에 사용되는 연결입니다 결과. 이곳은 모든 것을 초기화하기에 이상적인 장소입니다instanceata그것은 필요합니다 결과와 관련이 있습니다. 롤 토토 절차가 실패하면 결과가 지워지고 실패는 전파. 롤 토토 절차는 시도해서는 안됩니다PQCLEAR결과 객체 그 자체로. 실패 코드를 반환 할 때는 모두 정리하십시오 아니오로 수행해야합니다pgevt_resultdestroy롤 토토가 될 것입니다 전송된.

결과 사본 롤 토토가 응답하여 해고됩니다pqcopyresult. 이 행사 사본이 완료된 후에 만 해고됩니다. 롤 토토 만 롤 토토 성공적으로 처리 한 절차pgevt_resultcreate또는pgevt_resultcopy소스의 롤 토토 결과가 수신됩니다pgevt_resultcopy롤 토토.

typedef struct

    const pgresult *src;
    pgresult *dest;
 pgeventresultcopy;

언제pgevt_resultcopy롤 토토 접수,Evtinfo포인터가 a에 캐스트해야합니다pgeventresultcopy *. 그만큼SRC결과는 복사 한 내용입니다dest결과는 사본입니다 목적지. 이 롤 토토는 깊은 곳을 제공하는 데 사용될 수 있습니다 사본instanceata이후pqcopyresult그렇게 할 수 없습니다. 만약에 롤 토토 절차가 실패하면 전체 사본 작업이 발생합니다 실패와dest결과 지우십시오. 실패 코드를 반환 할 때는 모두 정리하십시오 아니오로 수행해야합니다pgevt_resultdestroy롤 토토가 발송됩니다 목적지 결과.

결과 파괴 롤 토토는 A에 대한 응답으로 해고되었습니다PQCLEAR. 롤 토토입니다 롤 토토를 올바르게 정리하는 절차의 책임 LIBPQ로서의 데이터는이 메모리를 관리 할 능력이 없습니다. 정리하지 않으면 메모리 누출이 발생합니다.

typedef struct

    pgresult *결과;
 pgeventresultdestroy;

언제pgevt_resultdestroy롤 토토가 접수되었습니다.evtinfo포인터가 a에 캐스트해야합니다pgeventresultdestroy *. 이 이벤트입니다 이전에 해고PQCLEAR다른 청소 수행. 의 반환 값 방법이 없기 때문에 롤 토토 절차는 무시됩니다. 실패를 나타내는PQCLEAR. 또한 롤 토토 절차 실패는 청소 과정을 중단해서는 안됩니다 원치 않는 기억.

pgeventproc는 typedef입니다 이벤트 절차, 즉 사용자에 대한 포인터 LIBPQ로부터 이벤트를 수신하는 콜백 함수. 그만큼 이벤트 절차의 서명은이어야합니다.

int eventProc (pgeventid evtid, void *evtinfo, void *passthrough)

theevtid매개 변수 어느 것을 나타냅니다pgevt이벤트 발생했습니다. 그만큼evtinfo포인터 얻기 위해 적절한 구조 유형으로 캐스트해야합니다. 이벤트에 대한 추가 정보. 그만큼Passthrough매개 변수는 포인터입니다 제공PQREGISTEREVENTPROC롤 토토 시점 절차가 등록되었습니다. 함수는 a 성공하면 0이 아닌 값이 실패하면 0입니다.

특정 롤 토토 절차 만 등록 할 수 있습니다 한 번pgconn. 이것은 절차의 주소는 조회로 사용되기 때문에 관련 인스턴스 데이터를 식별하는 키

롤 토토 콜백 절차를 LIBPQ로 등록합니다.

int pqregistereventProc (pgconn *conn, pgeventproc Proc,
                                const char *name, void *passthrough);

롤 토토 절차는 각각에 한 번 등록해야합니다pgconn당신은 받고 싶습니다 롤 토토. 메모리 외에는 제한이 없습니다 등록 할 수있는 이벤트 절차 수 연결과 함께. 함수는 0이 아닌 값을 반환합니다 실패하면 성공하고 0이되면

theProc인수가 될 것입니다 LIBPQ 롤 토토가 발사 될 때 호출됩니다. 메모리 주소입니다 또한 조회에 익숙해instanceata. 그만큼이름인수는 오류 메시지의 이벤트 절차. 이 가치는 될 수 없습니다 NULL 또는 제로 길이 문자열. 이름 문자열이 복사됩니다 에pgconn통과 된 것은 오래 지속될 필요는 없습니다. 그만큼Passthrough포인터가 전달됩니다Proc롤 토토가 발생할 때마다. 이 주장은 무일하다.

Proc에 대한 Conn의 Instancedata를 데이터로 설정합니다. 이것 성공을 위해 0이 아닌 반환하고 실패로 0이됩니다. (실패는 Proc가없는 경우에만 가능합니다. Conn에 올바르게 등록되었습니다.)

int pqsetinstanctata (pgconn *conn, pgeventproc proc, void *data);

Proc와 관련된 Conn의 Instanceata를 반환합니다. 또는 없으면 null.

void *pqinstancedata (const pgconn *conn, pgeventproc proc);

Proc에 대한 결과의 instancedata를 데이터로 설정합니다. 이것 성공을 위해 0이 아닌 반환하고 실패로 0이됩니다. (실패는 Proc가없는 경우에만 가능합니다. 결과에 올바르게 등록되었습니다.)

int pqresultsetinstancedata (pgresult *res, pgeventproc proc, void *data);

관련된 instanceata를 반환합니다 Proc, 또는 NOLL이없는 경우 NULL.

void *pqresultinstancedata (const pgresult *res, pgeventproc proc);