32.2. Chức năng trạng thái kèo bóng đá việt nam

Trả về tên cơ sở dữ liệu của kèo bóng đá việt nam.

char *pqdb (const pgconn *Conn);

Trả về tên người dùng của kèo bóng đá việt nam.

char *pquser (const pgconn *Conn);

Trả về mật khẩu của kèo bóng đá việt nam.

Char *PQPass (const pgconn *Conn);

Trả về tên máy chủ máy chủ của kèo bóng đá việt nam. Đây có thể là tên máy chủ, địa chỉ IP hoặc đường dẫn thư mục nếu kèo bóng đá việt nam thông qua ổ cắm UNIX./.)

char *pqhost (const pgconn *Conn);

Trả về cổng kèo bóng đá việt nam.

char *pqport (const pgconn *Conn);

Trả về gỡ lỗittycủa kèo bóng đá việt nam. (Điều này là lỗi thời, vì máy chủ không còn chú ý đếnttyCài đặt, nhưng chức kèo bóng đá việt nam vẫn cho khả kèo bóng đá việt nam tương thích ngược.)

char *pqtty (const pgconn *Conn);

Trả về các tùy chọn dòng lệnh được truyền trong yêu cầu kèo bóng đá việt nam.

char *pqoptions (const pgconn *Conn);

Trả về trạng thái của kèo bóng đá việt nam.

ConnstatusType pqStatus (const pgconn *Conn);

Trạng thái có thể là một trong một số giá trị. Tuy nhiên, chỉ có hai trong số này được nhìn thấy bên ngoài quy trình kèo bóng đá việt nam không đồng bộ:Connection_okvàConnection_Bad. Một kèo bóng đá việt nam tốt với cơ sở dữ liệu có trạng tháiConnection_ok. Một nỗ lực kèo bóng đá việt nam thất bại được báo hiệu bởi trạng tháiConnection_Bad. Thông thường, kèo bóng đá việt nam OK sẽ vẫn như vậy cho đến khipqfinish, nhưng lỗi truyền thông có thể dẫn đến kèo bóng đá việt nam thay đổi thànhConnection_Badsớm. Trong trường hợp đó, ứng dụng có thể cố gắng khôi phục bằng cách gọipqreset.

Xem mục choPQConnectStartParams, PQConnectStartvàPQConnectPollLiên quan đến các mã kèo bóng đá việt nam khác có thể được trả về.

Trả về kèo bóng đá việt nam chuyển đổi hiện tại của máy chủ.

kèo bóng đá việt nam có thể làPQTRANS_IDLE(hiện đang nhàn rỗi),pqtrans_active(một lệnh đang được tiến hành),pqtrans_intrans(nhàn rỗi, trong một khối giao dịch hợp lệ) hoặcpqtrans_inerror(nhàn rỗi, trong một khối giao dịch thất bại).pqtrans_unknownđược báo cáo nếu kèo bóng đá việt nam xấu.pqtrans_activechỉ được báo cáo khi truy vấn đã được gửi đến máy chủ và chưa hoàn thành.

tìm kiếm cài đặt tham số hiện tại của máy chủ.

const char *pqparameterstatus (const pgconn *Conn, const char *paramname);

Các giá trị tham số nhất định được báo cáo tự động khi khởi động kèo bóng đá việt nam hoặc bất cứ khi nào giá trị của chúng thay đổi.PQParameterstatuscó thể được sử dụng để thẩm vấn các cài đặt này. Nó trả về giá trị hiện tại của một tham số nếu được biết hoặcnullNếu tham số không được biết.

Các tham số được báo cáo là bản phát hành hiện tại bao gồmserver_version, server_encoding, client_encoding, application_name, is_superuser, session_Authorization, Datestyle, IntervalStyle, timezone, integer_datetimesvàStandard_Conforming_Strings. (server_encoding, timezonevàinteger_datetimeskhông được báo cáo bởi các bản phát hành trước 8.0;Standard_Conforming_StringsKhông được báo cáo bởi các bản phát hành trước 8.1;IntervalStyleKhông được báo cáo bởi các bản phát hành trước 8.4;application_namekhông được báo cáo bởi các bản phát hành trước 9.0.) Lưu ý rằngserver_version, server_encodingvàinteger_datetimesKhông thể thay đổi sau khi khởi động.

Máy chủ Pre-3.0-Protocol không báo cáo cài đặt tham số, nhưnglibpqBao gồm logic để có được giá trị choserver_versionvàclient_encodingDù sao. Các ứng dụng được khuyến khích sử dụngPQParameterstatuschứ không phảiad hocMã để xác định các giá trị này. (Tuy nhiên, hãy cẩn thận với kèo bóng đá việt nam Pre-3.0, thay đổiclient_encodingViasetSau khi kèo bóng đá việt nam khởi động sẽ không được phản ánh bởiPQParameterstatus.) Đối vớiserver_version, xem thêmPQServerVersion, trả về thông tin ở dạng số dễ dàng hơn nhiều để so sánh với.

Nếu không có giá trị choStandard_Conforming_Stringsđược báo cáo, các ứng dụng có thể giả sử đó làTẮT, nghĩa là, các dấu gạch chéo ngược được coi là trốn thoát trong các chuỗi chữ. Ngoài ra, sự hiện diện của tham số này có thể được coi là một dấu hiệu cho thấy cú pháp chuỗi thoát (E '...') được chấp nhận.

Mặc dù con trỏ được trả lại được khai báoconst, trên thực tế chỉ vào bộ lưu trữ có thể thay đổi được liên kèo bóng đá việt nam vớiPGConnCấu trúc. Không khôn ngoan khi cho rằng con trỏ sẽ vẫn còn hiệu lực trên các truy vấn.

thẩm vấn giao thức Frontend/phụ trợ đang được sử dụng.

int pqProtocolVersion (const pgconn *Conn);

Các ứng dụng có thể muốn sử dụng chức năng này để xác định xem một số tính năng nhất định có được hỗ trợ hay không. Hiện tại, các giá trị có thể là 2 (giao thức 2.0), giao thức 3 (3.0) hoặc 0 (kèo bóng đá việt nam xấu).PostgreSQL7.4 hoặc các máy chủ hoặc sau đó; Máy chủ trước 7.4 chỉ hỗ trợ giao thức 2.0.libpq.)

Trả về một số nguyên đại diện cho phiên bản phụ trợ.

int pqserverversion (const pgconn *Conn);

Các ứng dụng có thể sử dụng chức năng này để xác định phiên bản của máy chủ cơ sở dữ liệu mà chúng được kèo bóng đá việt nam. Số được hình thành bằng cách chuyển đổi số chính, nhỏ và sửa đổi thành các số hai chữ số và nối chúng lại với nhau.

Trả về thông báo lỗi được tạo gần đây nhất bởi một thao tác trên kèo bóng đá việt nam.

char *pqerrormessage (const pgconn *Conn);

Gần như tất cảlibpqCác chức kèo bóng đá việt nam sẽ đặt tin nhắn chopqerrormessageNếu họ thất bại. Lưu ý rằng bằnglibpqquy ước, một người không trốngpqerrormessagekèo bóng đá việt nam quả có thể bao gồm nhiều dòng và sẽ bao gồm một dòng mới. Người gọi không nên giải phóng kèo bóng đá việt nam quả trực tiếp.PGConnXử lý được chuyển chopqfinish. Chuỗi kèo bóng đá việt nam quả không nên được dự kiến ​​sẽ giữ nguyên trong các hoạt động trênPGConnCấu trúc.

Lấy số lượng mô tả tệp của ổ cắm kèo bóng đá việt nam vào máy chủ. Một mô tả hợp lệ sẽ lớn hơn hoặc bằng 0;

int pqsocket (const pgconn *Conn);

Trả về quy trìnhid(pid) của quá trình phụ trợ xử lý kèo bóng đá việt nam này.

int pqbackendPid (const pgconn *Conn);

phụ trợPIDlà hữu ích cho mục đích gỡ lỗi và để so sánh vớiThông báoTin nhắn (bao gồmPIDcủa quy trình phụ trợ thông báo). Lưu ý rằngPIDthuộc về quá trình thực thi trên máy chủ máy chủ cơ sở dữ liệu, không phải máy chủ cục bộ!

Trả về đúng (1) Nếu phương thức xác thực kèo bóng đá việt nam yêu cầu mật khẩu, nhưng không có sẵn. Trả về false (0) nếu không.

22433_22485

Hàm này có thể được áp dụng sau khi kèo bóng đá việt nam thất bại cố gắng quyết định có nhắc người dùng về mật khẩu hay không.

Trả về đúng (1) Nếu phương thức xác thực kèo bóng đá việt nam sử dụng mật khẩu. Trả về false (0) nếu không.

22898_22949

Hàm này có thể được áp dụng sau khi cố gắng kèo bóng đá việt nam thành công hoặc không thành công để phát hiện xem máy chủ có yêu cầu mật khẩu hay không.

Trả về true (1) Nếu kèo bóng đá việt nam sử dụng SSL, false (0) nếu không.

int pqsslinuse (const pgconn *Conn);

Trả về thông tin liên quan đến SSL về kèo bóng đá việt nam.

23737_23814

Danh sách các thuộc tính có sẵn khác nhau tùy thuộc vào thư viện SSL đang được sử dụng và loại kèo bóng đá việt nam. Nếu một thuộc tính không khả dụng, hãy trả về null.

Các thuộc tính sau đây thường có sẵn:

Trả về một mảng tên thuộc tính SSL có sẵn. Mảng bị chấm dứt bởi một con trỏ null.

const char * const * pqsslattributenames (const pgconn * Conn);

25626_25712

25737_25802

Cấu trúc có sẵn phụ thuộc vào việc thực hiện SSL đang sử dụng. Đối với OpenSSL, có một cấu trúc, có sẵn dưới tên "OpenSSL" và nó trả về một con trỏ cho OpenSSLSSLCấu trúc. Để sử dụng chức kèo bóng đá việt nam này, mã dọc theo các dòng sau có thể được sử dụng:

#include <libpq-fe.h

Cấu trúc này có thể được sử dụng để xác minh các mức mã hóa, kiểm tra chứng chỉ máy chủ và hơn thế nữa. Tham khảoOpenSSLTài liệu cho thông tin về cấu trúc này.

Trả về cấu trúc SSL được sử dụng trong kèo bóng đá việt nam hoặc null nếu SSL không được sử dụng.

VOID *PQGETSSL (const pgconn *Conn);

Hàm này tương đương vớiPQSSLStruct (Conn, "OpenSSL"). Nó không nên được sử dụng trong các ứng dụng mới, bởi vì cấu trúc được trả lại là cụ thể cho OpenSSL và sẽ không có sẵn nếu việc triển khai SSL khác được sử dụng.PQSSlinuseThay vào đó, và để biết thêm chi tiết về kèo bóng đá việt nam, sử dụngPQSSlattribution.