SPI_connect

Название

SPI_connect -- подключить процедуру к менеджеру SPI

Синтаксис

int SPI_connect(void)

Описание

SPI_connect устанавливает подключение вызова процедуры к менеджеру SPI. Эту функцию необходимо вызвать, если вы хотите выполнять команды через SPI. Некоторые вспомогательные функции SPI могут вызываться из неподключённых процедур.

Если ваша процедура уже подключена, SPI_connect возвратит код ошибки SPI_ERROR_CONNECT. Это может произойти, если процедура, которая вызвала SPI_connect, непосредственно вызывает другую процедуру, снова вызывающую SPI_connect. Хотя рекурсивные обращения к менеджеру SPI, когда команда SQL, выполняемая через SPI, вызывает функцию, тоже использующую SPI, возможны, непосредственные вложенные вызовы SPI_connect и SPI_finish запрещены. (Но обратите внимание на SPI_push и SPI_pop.)

Возвращаемое значение

SPI_OK_CONNECT

при успехе

SPI_ERROR_CONNECT

при ошибке

SPI_connect

Name

SPI_connect -- connect a procedure to the SPI manager

Synopsis

int SPI_connect(void)

Description

SPI_connect opens a connection from a procedure invocation to the SPI manager. You must call this function if you want to execute commands through SPI. Some utility SPI functions can be called from unconnected procedures.

If your procedure is already connected, SPI_connect will return the error code SPI_ERROR_CONNECT. This could happen if a procedure that has called SPI_connect directly calls another procedure that calls SPI_connect. While recursive calls to the SPI manager are permitted when an SQL command called through SPI invokes another function that uses SPI, directly nested calls to SPI_connect and SPI_finish are forbidden. (But see SPI_push and SPI_pop.)

Return Value

SPI_OK_CONNECT

on success

SPI_ERROR_CONNECT

on error

FAQ