레지스터 토토 결과는 발생할 때 발생합니다.PQREGISTEREVENTPROC호출됩니다. 모든 것을 초기화하기에 이상적인 시간입니다instanceata토토 결과 절차가 필요할 수 있습니다. 연결 당 토토 결과 핸들러 당 하나의 레지스터 토토 결과 만 해고됩니다. 토토 결과 절차가 실패하면 (반환 0) 등록이 취소됩니다.

typedef struct

    pgconn *conn;
 pgeventRegister;

언제pgevt_register토토 결과가 접수되었습니다.evtinfo포인터가 a에 캐스트해야합니다pgeventRegister *. 이 구조에는가 포함되어 있습니다.pgconnConnection_ok상태; 전화가 보장 보장PQREGISTEREVENTPROC선을 얻은 직후pgconn. 실패 코드를 반환 할 때는 모든 정리를 수행해야합니다PGEVT_CONNDESTROY토토 결과가 발송됩니다.

연결 재설정 토토 결과는 완료시 발사되었습니다.pqreset또는pqresetpoll. 두 경우 모두 토토 결과는 재설정이 성공한 경우에만 해고됩니다. 토토 결과 절차의 반환 값은 무시됩니다PostgreSQLv15 이상. 그러나 이전 버전에서는 성공을 반환하는 것이 중요합니다 (0이 아닌). 연결이 중단됩니다.

typedef struct

    pgconn *conn;
 pgeventconnreset;

언제PGEVT_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;

언제pgevt_resultcreate토토 결과가 접수되었습니다.evtinfo포인터가 a에 캐스트해야합니다pgeventresultcreate *. 그만큼conn토토 결과를 생성하는 데 사용되는 연결입니다. 이곳은 모든 것을 초기화하기에 이상적인 장소입니다instanceata결과와 관련이 있어야합니다. 토토 결과 절차가 실패하면 (returns zero), 해당 토토 결과 절차는 결과의 나머지 수명에 대해 무시됩니다. 즉,받지 못할 것입니다pgevt_resultcopy또는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그렇게 할 수 없습니다. 토토 결과 절차가 실패하면 (0을 반환), 새로운 결과의 나머지 수명에 대해 해당 토토 결과 절차가 무시됩니다. 즉,받지 못할 것입니다pgevt_resultcopy또는pgevt_resultdestroy그 결과 또는 결과에 대한 이벤트 또는 결과로 복사.

결과 파괴 토토 결과는 A에 대한 응답으로 해고됩니다PQCLEAR. libpq 가이 메모리를 관리 할 수 없기 때문에 이벤트 데이터를 올바르게 정리하는 것은 이벤트 절차의 책임입니다. 정리하지 않으면 메모리 누출이 발생합니다.

typedef struct

    pgresult *결과;
 pgeventresultdestroy;

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

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

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

theevtid매개 변수는를 나타냅니다.pgevt이벤트가 발생했습니다. 그만큼evtinfo이벤트에 대한 추가 정보를 얻으려면 포인터를 적절한 구조 유형으로 캐스트해야합니다. 그만큼Passthrough매개 변수는 제공된 포인터입니다PQREGISTEREVENTPROC토토 결과 절차가 등록 된 시점. 기능이 성공하면 0이 아닌 값을 반환하고 실패하면 0이됩니다.

특정 토토 결과 절차는 한 번만 등록 할 수 있습니다pgconn. 프로 시저의 주소가 관련 인스턴스 데이터를 식별하기위한 조회 키로 사용되기 때문입니다.

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

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

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

theProcLIBPQ 토토 결과가 해고되면 인수가 호출됩니다. 메모리 주소는 조회에도 사용됩니다instanceata. 그만큼이름인수는 오류 메시지의 토토 결과 절차를 참조하는 데 사용됩니다. 이 값은 될 수 없습니다null또는 제로 길이 문자열. 이름 문자열이에 복사됩니다.pgconn, 통과 된 것은 오래 지속될 필요는 없습니다. 그만큼Passthrough포인터가 전달됩니다Proc토토 결과가 발생할 때마다. 이 주장은NULL.

연결 설정conn'sinstanceata절차Procto데이터. 이것은 성공을 위해 0이 아닌 반환하고 실패로 0이됩니다. (실패는 경우에만 가능합니다Proc에 제대로 등록되지 않았습니다conn.)

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

연결을 반환conn'sinstanceata절차와 관련된Proc또는NULL없는 경우.

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

토토 결과 설정instanceataforProcto데이터. 이것은 성공을 위해 0이 아닌 반환하고 실패로 0이됩니다. (실패는 경우에만 가능합니다Proc결과에 제대로 등록되지 않았습니다.)

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

데이터pqresultMemorySize를 사용하여 할당되지 않는 한pqresultalloc. (결과가 파괴 될 때 그러한 스토리지를 명시 적으로 제거 할 필요가 없기 때문에 그렇게하는 것이 좋습니다.)

토토 결과를 반환합니다instanceata관련Proc또는NULL없는 경우.

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