[Top] [Prev] [Next] [Bottom] [Contents]

getSgeWorkCallData

Allocates a data structure which is used to execute a Stored Procedure. This function is used in generating Sapphire/Web code and probably will not be used by application programmers. It is documented here so that you can understand Sapphire/Web-generated code.

Synopsis

#include "WorkingDialog.h"
pSgeWorkCallData getSgeWorkCallData(	Widget w, 
											long max, 
											char *serv, 
											char* db, 
											char* sproc, 
											int usage);

Arguments

w
Widget used as an activator for the Stored Procedure or DSQL Object.
max
The maximum number of rows to be returned for each results group. A value of -1 means all rows.
serv
The server name where the Stored Procedure or DSQL Object will execute.
db
The database name where the Stored Procedure or DSQL Object will execute.
sproc
The Stored Procedure or DSQL Object name that will execute.
usage
Specifies which mode the Stored Procedure or DSQL Object will use when executing.

Return Values

A pointer to an allocated pSgeWorkCallData structure. This is an opaque pointer.

Description

getSgeWorkCallData allocates a data structure which is used to execute a Stored Procedure or DSQL Object. A NULL return value indicates that the allocation failed. If serv, db, or sproc is NULL, the allocation will fail. If the Stored Procedure or DSQL Object is running, the allocation will fail. The parameter, w, must be a valid Widget, or NULL. The parameter, max, specifies the maximum number of rows to be returned per results group. A value of -1 indicates all rows. The parameter, usage, specifies which mode the Stored Procedure or DSQL Object will use when executing. The only value is: NO_WP.

Example

pSgeWorkCallData pSgeWCD;
pSgeWCD = getSgeWorkCallData(UxWidget, -1, "CEZANNE", 
										"pubs2", "StoreSalesProc",
										NO_WP);
if (pSgeWCD == NULL)
	return;
Note: For Oracle users, the server name must be "Oracle" and the database name is your Database Name, Alias, or Connection String.

See Also



[Top] [Prev] [Next] [Bottom] [Contents]

info@bluestone.com
Copyright © 1997, Bluestone. All rights reserved.