spi_connect

SPI_connect()	       PostgreSQL 7.4.19 Documentation		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 may 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 for-
       bidden.

RETURN VALUE
       SPI_OK_CONNECT
	      on success

       SPI_ERROR_CONNECT
	      on error



				  2008-01-03			SPI_connect()