LoadRunner函数大全之中文解释

msnshow

char * lr_get_vuser_ip( );  
  
// lr_get_master_host_name  函数返回运行  
//  控制器或优化模块控制台的计算机的名称。  
char * lr_get_master_host_name ( );  
  
// lr_get_transaction_duration  函数返回  
//  到该点为止指定事务的持续时间（秒）  
//   。使用该函数可确定  
//  事务结束前的总  
//  事务时间。lr_get_transaction_duration  只针对打开事务返回  
//  大于零的值。  
double lr_get_transaction_duration (const char * transaction);  
  
// lr_get_transaction_status  返回事务的  
//  当前状态。不能在  lr_end_transaction  之后  
//  调用  lr_get_transaction_status 。由于  lr_get_transaction_status  
//  只能返回打开事务的状态，因此  
//  无法报告最终的事务状态。  
int lr_get_transaction_status ( const char *transaction_name ) ;  
  
// lr_get_trans_instance_status  返回事务实例的  
//  当前状态。不能在  lr_end_transaction_instance  之后  
//  调用  lr_get_trans_instance_status 。它  
//  无法报告最终的事务实例状态。  
int lr_get_trans_instance_status ( long transaction_handle ) ;  
  
// lr_get_trans_instance_duration  函数返回  
//  到该点为止打开事务实例的持续  
//  时间（秒）。使用该函数可确定事务结束前  
//  的总事务时间。  
double lr_get_trans_instance_duration (long trans_handle);  
  
// lr_get_transaction_think_time  函数返回  
//  到该点为止指定事务的  
//  思考时间。它只针对打开事务返回  
//  大于零的值。  
double lr_get_transaction_think_time (const char * transaction);  
  
// lr_get_trans_instance_think_time  函数返回  
//  到该点为止指定事务的思考时间。  
double lr_get_trans_instance_think_time (long trans_handle);

msnshow

// lr_get_transaction_wasted_time  函数返回  
//  到该点为止指定事务的浪费时间（秒）。  
double lr_get_transaction_wasted_time (const char * transaction);  
  
// lr_get_trans_instance_wasted_time  函数返回  
//  到该点为止指定事务的浪费时间。  
double lr_get_trans_instance_wasted_time (long trans_handle);  
  
// lr_load_dll  函数加载  DLL (Windows)  
//  或共享对象  (UNIX) ，使您可以在  
//  使用  C  解释器回放时调用外部函数。加载  
// DLL  之后，您就可以调用  DLL  中定义的  
//  任何函数，而不必声明。  
int lr_load_dll (const char *library_name );  
  
// lr_log_message  函数将消息发送到  
// Vuser  或代理日志文件（取决于应用程序），  
//  而不是发送到输出窗口。通过向日志文件发送错误消息或  
//  其他信息性消息，可以将  
//  该函数用于调试。  
int lr_log_message (const char * format, exp1, exp2,...expn.);  
  
// lr_message  函数将消息发送到日志文件和  
//  输出窗口。在  VuGen  中运行时，输出文件为  output.txt 。  
int lr_message (const char * format, exp1, exp2,...expn.);  
  
// lr_output_message  函数将带有脚本部分和行号的消息  
//  发送到输出窗口和日志文件。  
int lr_output_message (const char * format, exp1, exp2,...expn.);  
  
// lr_next_row  函数获取指定文件中参数的  
//  下一个可用行的值。如果  
//  要运行多次循环，可以在参数  
//  属性中指定前进到每次循环  
//  的下一行。在特定循环中使用  
//  该函数，可以前进到下一组值。  
int lr_next_row ( const char * dat_file );  
  
// lr_param_increment  函数检索   
// source_param  的值，并以  1  为单位递增其值，  
//  然后将递增后的值作为  null  终止字符串  
//  存储在  destination_param   中。  
int lr_param_increment (const char * destination_param, const char * source_param);

msnshow

// lr_peek_events  函数用于在脚本执行期间  
//  的特定时刻接收事件。应将该函数  
//  插入到  Vuser  程序中希望  Vuser  暂停的  
//  位置。如果脚本中不  
//  包含  lr_peek_events  函数，您将无法  
//  暂停  Vuser 。  
void lr_peek_events ( );  
  
// lr_rendezvous_ex  函数在  Vuser  脚本中创建  
//  一个集合点。执行该语句时，  
// Vuser  程序会停止并等待  LoadRunner  赋予  
//  权限以便继续。  
int lr_rendezvous_ex (const char * rendezvous_name);  
  
// lr_rendezvous  函数在  Vuser  脚本中  
//  创建一个集合点。执行该语句时，  
// Vuser  程序会停止并等待  LoadRunner  赋予  
//  权限以便继续。  
int lr_rendezvous (const char * rendezvous_name);  
  
// lr_resume_transaction  函数继续执行  
//  被  lr_stop_transaction  挂起的脚本中  
//  事务数据的报告。调用  lr_stop_transaction  之后，  
//  “get ”事务函数返回的统计信息  
//  只反映该调用之前的数据，  
//  直到调用此函数。  
void lr_resume_transaction (const char * transaction_name);  
  
// lr_resume_transaction_instance  函数可以继续报告由   
// lr_stop_transaction_instance  挂起的脚本中的  
//  事务数据。  
//  调用  lr_stop_transaction_instance  后，  
//  “get ”事务函数返回的统计信息  
//  只反映该调用之前的数据，直到调用  
//  此函数。  
void lr_resume_transaction_instance ( long trans_handle );  
  
// lr_save_datetime  函数将当前日期  
//  和时间，或具有指定偏移的日期和时间  
//  保存在参数中。如果达到  MAX_DATETIME_LEN  个字符，  
//  结果字符串将截断。  
void lr_save_datetime(const char *format, int offset, const char *name);

msnshow

// lr_save_searched_string  函数在字符串  
//  或字符数组缓冲区中搜索字符串  search_string ，  
//  并找到  search_string  第  n  次出现的位置，其中  
// n  为  occurrence  加  1 。要保存的子字符串  
//  从  search_string  第  n  次出现位置的末尾偏移  offset  处开始，  
//  长度为  string_len 。  
int lr_save_searched_string (const char *buffer, long buf_size, unsigned int occurrence, const char  
*search_string, int offset, unsigned int string_len, const char *parm_name );  
  
// lr_save_string  函数将指定的以  null  终止的  
//  字符串赋给参数。该函数可用于关联  
//  查询。要确定参数值，请使用  
//  函数  lr_eval_string 。  
int lr_save_string (const char *param_value, const char *param_name);  
  
// lr_save_var function  函数将指定的变长  
//  字符串赋给参数。该函数可用于  
//  关联查询。要确定参数值，  
//  请使用函数  lr_eval_string 。  
int lr_save_var (const char * param_value, unsigned long const value_len, unsigned long const  
options, const char * param_name);  
  
// lr_set_debug_message  函数设置脚本  
//  执行的调试消息级别  message_lvl 。通过设置  
//  消息级别，可以确定发送哪些  
//  信息。启用设置的方法是将  LR_SWITCH_ON  作为  on_off  传递，  
//  禁用设置的方法是传递  LR_SWITCH_OFF 。  
int lr_set_debug_message (unsigned int message_level, unsigned int on_off);  
  
// lr_set_transaction  函数用于在一次调用中  
//  创建事务、其持续时间及  
//  状态。如果要在事务中捕获的  
//  业务流程不由顺序步骤组成，  
//  或者是否要创建事务视  
//  只有在测试过程中才可知的条件而定，  
//  请使用该函数。  
int lr_set_transaction(const char *name, double duration, int status);  
  
// lr_set_transaction_instance_status  函数使用  
//  事务句柄为  trans_handle  设置打开事务的  
//  状态。该句柄由  
// lr_start_transaction_instance  返回。  
int lr_set_transaction_instance_status (int status, long trans_handle);

msnshow

// lr_set_transaction_status  函数设置  
//  那些在其  lr_end_transaction  语句中包含  LR_AUTO   的  
//  当前打开事务的状态。  
int lr_set_transaction_status (int status);  
  
// lr_set_transaction_status_by_name  函数使用  
//  名称  trans_name  设置打开事务的  
//  默认状态。该事务的  lr_end_transaction  
//  语句必须使用自动状态分配，方法是  
//  将  LR_AUTO  作为其  status  参数传递。  
int lr_set_transaction_status_by_name (int status, const char *trans_name);  
  
// lr_start_transaction  函数标记  
//  事务的开始。要指明要分析的  
//  事务，请使用函数  lr_start_transaction  和  
// lr_end_transaction 。应紧接事务前后  
//  插入这些函数。  
int lr_start_transaction ( const char * transaction_name );  
  
// lr_start_transaction_instance  函数标记  
//  事务实例的开始。事务  
//  实例是名为  transaction_name  的事务的一次  
//  发生。实例由它们的句柄  
//  标识，句柄使它们区别于  
//   同一事务的其他实例。  
long lr_start_transaction_instance ( const char * transaction_name, long handle);  
  
// lr_start_sub_transaction  函数标记  
//  子事务的开始。要标记子事务  
//  的结束，请使用  lr_end_sub_transaction 。  
//  请紧接子事务操作前后  
//  插入这些函数。  
int lr_start_sub_transaction (const char * sub_transaction, const char * parent_transaction);  
  
//  调用  lr_stop_transaction  后，  
//  “get ”事务函数返回的统计信息只反映  
//  该调用之前的数据，直到调用  lr_resume_transaction  
//   。指定的事务必须已  
//  使用  lr_start_transaction  打开。  
double lr_stop_transaction (const char * transaction_name);  
  
//  调用  lr_stop_transaction_instance  后，  
//  “get ”事务函数返回的统计信息  
//  只反映该调用之前的数据，直到调用  lr_resume_transaction_instance  。指定的事务实例  
//  必须已使用  lr_start_transaction_instance  打开。

msnshow

double lr_stop_transaction_instance (long parent_handle);  
  
//  通过  lr_think_time  可以在运行期间暂停测试  
//  执行。这对于模拟思考时间非常有用，  
//  思考时间是真实用户在操作之间停下来思考的时间。  
void lr_think_time (double time);  
  
//  通过函数  lr_user_data_point ，可以记录  
//   自己的数据以进行分析。每次要记录一个点  
//  时，请使用该函数记录采样名称和  
//  值。将自动记录采样的时间。  
//  执行后，可以使用用户定义的数据  
//  点图形来分析结果。  
int lr_user_data_point (const char * sample_name, double value);  
  
//  除附加参数  log_flag  之外，函数  lr_user_data_point_ex  
//  与  lr_user_data_point  相同。  
int lr_user_data_point_ex ( const char *sample_name, double value, int log_flag);  
  
//  除参数  transaction_handle      （通过该参数可以  
//  将数据点与某个特定事务实例关联起来）之外，  
//  函数  lr_user_data_point_instance  
//  与  lr_user_data_point  相似。  
long lr_user_data_point_instance (const char * sample_name, double value, long  
transaction_handle);  
  
//  除附加参数函数  log_flag  之外，函数  
// lr_user_data_point_instance_ex  与  
// lr_user_data_point_instance  相同。  
long lr_user_data_point_instance_ex (const char*sample_name, double value, long  
transaction_handle, int log_flag);  
  
// lr_vuser_status_message  函数向控制器  
//  或优化模块控制台的  Vuser  窗口的“状态”区域  
//  发送字符串。它还将该字符串  
//  发送到  Vuser   日志。从  VuGen  运行时，  
//  消息被发送到  output.txt 。  
int lr_vuser_status_message (const char * format);  
  
//  通过  lr_wasted_time  可以从所有打开事务中  
//  减去在偶然或次要的操作上浪费的时间。  
void lr_wasted_time (long time);

msnshow

// lr_whoami  函数获取关于  Vuser  的信息。  
void lr_whoami (int *vuser_id, char **sgroup, int *scid);  
  
// radius_account  模拟  RAS  或  NAS  服务器，该服务器  
//   向  RADIUS  服务器发送记帐信息。  
//  请将其插入在  radius_authenticate  调用之后、  
// WAP  会话之前或过程中。  
int radius_account(const char *AccountName, const char *Action, <List of Arguments>, LAST);  
  
// radius_authenticate  模拟  RAS  或  NAS  服务器，该服务器  
//  在允许用户访问  WAP   网关之前，  
//   向  RADIUS  服务器发送用户的身份验证信息。  
//  请将其插入在调用  wap_connect  之前。  
int radius_authenticate(<List of Arguments>, LAST);  
  
// radius_get_last_error  返回最近的  RADIUS  
//  函数调用的错误代码。  
int radius_get_last_error ();  
  
// radius_set_timeout  为函数  radius_authenticate  
//  和  radius_account functions  设置连接超时值。它  
//  会覆盖  RADIUS  运行时设置中的超时值  
//  设置。参数  Timeout  是以秒为单位的超时值  
//  的字符串表示。例如“5 ”。  
int radius_set_timeout (const char *Timeout);  
  
// wap_add_const_header  函数向常量头列表中  
//  添加一个头。当建立  CO  类型的连接时，这些头  
//  被传送至网关。  
int wap_add_const_header ( const char *mpszHeader, const char *mpszValue );  
  
// wap_bearer_down  可以断开与承载网络的连接。  
//  载体是  WAP   网络的最底层服务。  
//  有关详细信息，请参阅  wap_bearer_up 。  
int wap_bearer_down();  
  
// wap_bearer_up  可以连接到承载网络。承  
//  载体是  WAP   网络的最底层服务。  
//  当测试只包括  SMS  消息时该函数非常有用，  
//  使您不必使用  wap_connect  连接至  
// WAP   网关。  
int wap_bearer_up();

msnshow

// wap_connect  函数可以连接至  WAP   网关，网关的  
// IP  地址和端口在运行时设置中指定。  
int wap_connect (    );  
  
// wap_disconnect  函数可以断开与  WAP   网关的连接。  
//  连接是通过调用  wap_connect  或  web_url  打开的。  
int wap_disconnect (    );  
  
// wap_format_si_msg  函数可以格式化  SI  类型的消息。  
int    wap_format_si_msg (const char * mpszURL, const char * Slid,    const char * mpszCreated,  
const char * mpszExpires, const char * mpszAction, const char * mpszUserMsg, char *  
mpsfOutputMsg, unsigned int miOutputMsglen );  
  
// wap_format_sl_msg  函数可以格式化  SL  类型的消息。  
int    wap_format_sl_msg (const char * mpszURL, const char * mpszAction,    char *  
mpsfOutputMsg, unsigned int miOutputMsglen );  
  
// wap_mms_msg_decode  函数可以将字符串转换为  
// MMS  消息对象。通常，该字符串  
//  是接收到的  HTTP  消息的正文。  
int wap_mms_msg_decode(void **MMSObject, const char *ParamName);  
  
// wap_mms_msg_encode  函数可以将  
// wap_mms_msg_create  创建的  MMS  消息对象  (MMSObject)  
//  转换为字符串，该字符串随后可用于  Web  操作函数。  
//  该方法不同于使用  wap_mms_msg_submit  
//  或  as_wap.h  头文件中的其他宏，后者  
//  直接接受  MMS  消息对象。  
int wap_mms_msg_encode(void *MMSObject, const char *ParamName);  
  
// wap_mms_msg_get_field  从  MMSObject   中  
//  检索指定字段  FieldName  的值，  
//  并将其存储在参数  ParamName   中。  
int wap_mms_msg_get_field(void *MMSObject, const char *FieldName, const char  
*ParamName);  
  
// wap_mms_msg_get_multipart_entry  从  MMSObject  
//   中的多部分项  EntryNumber   中  
//  检索指定字段  FieldName  的值，  
//  并将其存储在参数  ParamName   中。  
int wap_mms_msg_get_multipart_entry(void *MMSObject, unsigned int EntryNumber, const  
char *FieldName, const char *ParamName);  
  
// wap_mms_msg_number_multipart_entries  可以检索

msnshow

// MMSObject   中多部分项的数目。  
int wap_mms_msg_number_multipart_entries(void *MMSObject, unsigned int  
*NumberOfEntries);  
  
// wap_pi_push_submit  函数可以向  PPG  提交一个“推”消息。  
int    wap_pi_push_submit(const char * mpszName, const char * mpszURL, const char *  
mpszPushID, const char * mpszClientAddress, const char * mpszDeliverBefore, const char *  
mpszDeliverAfter, const char * mpszMsgSource, const char * mpszMsgType, const char *  
mpszMsgContent);  
  
// wap_pi_push_submit_ex  函数可以向  PPG  提交一个“推”消息。  
int    wap_pi_push_submit_ex(const char * mpszName, const char * mpszURL, const char *  
mpszPushID, const char * mpszClientAddress, const char * mpszDeliverBefore, const char *  
mpszDeliverAfter, const char * mpszMsgSource, const char * mpszMsgType, const char *  
mpszMsgContent [, CustomAttributes]);  
  
// wap_pi_push_cancel  函数可以取消一个发送到  PPG  的消息。  
int    wap_pi_push_cancel(const char * mpszName, const char * mpszURL, const char *  
mpszPushID, const char * mpszClientAddress);  
  
// wap_radius_connection   已过时。请使用  
// radius_authenticate  和  radius_account 。  
int wap_radius_connection (const char * mpszAction, <List of Arguments>, LAST);  
  
// wap_set_bearer  函数可以设置用于重放  
// UDP  或  CIMD2 (SMS)  的载体类型。脚本使用该  
//  载体类型，直到脚本结束或  
//  再一次调用函数  wap_set_bearer  进行设置。  
int wap_set_bearer ( const char *mpszBearer );  
  
// wap_set_capability  函数可以设置网关连接的  
//  客户端容量。建立网关连接时，  
//  将对这些容量进行协商。  
int wap_set_capability ( const char *mpszCap );  
  
// wap_set_connection_mode  函数可以设置会话的连接  
//  模式和安全级别。需要指明  
//  连接的连接模式类型  
//  和安全级别。该函数只对以后的  
//  连接有效。如果连接已经建立，  
//  则忽略该函数。  
int wap_set_connection_mode( const char *    ConnectionMode,                                                      
const char * SecurityLevel);

msnshow

// wap_set_connection_options  可以设置：IP  地址和端口  
//  （通过它们与网关通信）、连接  
//  模式、安全级别和载体类型  
int wap_set_connection_options&#40; const char *argument_list, ..., LA&#83;T);  
  
// wap_set_gateway  函数可以设置  IP  地址和  
//  端口，通过它们可以与网关通信。  
int    wap_set_gateway&#40; const char * GateWayIP, const char * GateWayPort );  
  
// wap_set_sms_user  可以设置  &#83;M&#83;  载体  
//  的登录信息。可以在“运行时设置”的  
//  “网关”选项卡中设置载体的端口和  
//  登录信息。该函数必须位于  wap_connect  
//  或第一个  web_url  函数之前。  
int wap_set_sms_user &#40;const char *argument_list, ..., LA&#83;T);  
  
// wap_wait_for_push  函数等待一个“推”消息  
//  到达。如果超时前有消息到达，  
//  则解析该消息，以确定其类型和  
//  消息属性的值。如果解析成功，  
//  客户端会发出一个“拉”消息，以检索  
//  相关数据。通过配置运行时设置，可以禁用“拉”事件，  
//  指明不检索消息  
//  数据。在文件  default.cfg   中找到  
// WAP  部分。将标志  PushRetrieveMsg  设置为  
// 1  可以检索消息（默认），设置为  0  可以  
//  禁止消息。  
int wap_wait_for_push &#40; );  
  
// wap_mms_msg_destroy  函数可以销毁  
//  使用  wap_mms_msg_create  或  wap_mms_msg_decode  创建的消息。  
//  请在已确认消息后将该函数放置在  
//  脚本末尾。如果会话结束时  
//  不销毁  MM&#83;  消息，它将使用额外  
//  资源并影响性能。  
int wap_mms_msg_destroy &#40;void * MM&#83;Object );  
  
// wap_mms_msg_create  函数可以创建消息。  
//  请在建立与服务器的连接后  
//  将该函数放置在脚本开头。  
//  在会话结束时，请使用函数  wap_mms_msg_destroy  
//  销毁该消息。  
int wap_mms_msg_create &#40;void **MM&#83;Object );

msnshow

// wap_mms_msg_add_field  函数可以向  MMS  消息添加消息字段，  
//  添加的内容包括字段名和值。可以  
//  在脚本中多次使用该函数。  
int wap_mms_msg_add_field (void * MMSObject, const char * FieldName,                                                                    
const char * FieldValue );  
  
// wap_mms_msg_add_multipart_entry  函数可以向  MMS  消息  
//  添加多部分项。项  
//  可以是字符串（在最后一个参数中指定），  
//  也可以是外部文件。可以在脚本中  
//  多次使用该函数。  
int wap_mms_msg_add_multipart_entry (void ** MMSObject,      const char *DataSource, const  
char * ContentType,      const char *Headers, const char * Data );  
  
// wap_mms_msg_retrieve  函数可以向  MMS   中心  
//  发送请求，以获得  URL  处的消息。MMS  
//   中心将消息写入  Message 。它作为  
//  文件  as_wap.h   中的一个宏实现。  
void wap_mms_msg_retrieve (Name, URL, Message); /* MACRO (char*, char*, void**) */  
  
// wap_mms_msg_retrieve_by_push  函数等待  
//  “推”消息到达。收到  
//  该消息后，客户端将发出一个“拉”消息，  
//   以检索相关数据。  
void wap_mms_msg_retrieve_by_push (Message); /* MACRO (void**) */  
  
// wap_mms_msg_submit  函数可以向  MMS  服务器  
//  发送消息  MMSMessage 。它作为  
//  文件  as_wap.h   中的一个宏实现。  
void wap_mms_msg_submit (Name, URL, Message); /* MACRO (char*, char*, void*) */  
  
// wap_mms_msg_submit  函数使用指定的内容类型  
//   向  MMS  服务器发送消息  MMSMessage 。它作为  
//  文件  as_wap.h   中的一个宏实现。  
void wap_mms_msg_submit_enc (Name, URL, Message, EncodingType ); /* MACRO (char*,  
char*, void*, char*) */  
  
// wap_mms_msg_submit_and_receive_enc  函数使用指定的  
//   内容类型向  MMS  服务器发送消息  Message ，  
//  并在返回前同步接收响应  
// ReceivedMMS 。它作为  
//  文件  as_wap.h   中的一个宏实现。  
void wap_mms_msg_submit_and_receive_enc (Name, URL, Message, ReceivedMMS,  
EncodingType ); /* MACRO (char*, char*, void*, void**, char*) */

msnshow

// wap_mms_msg_submit_and_receive  函数向  MMS  服务器  
//  发送消息  Message ，并在返回前  
//   同步接收响应  ReceivedMMS 。  
//  它作为文件  as_wap.h  中的一个宏实现。  
void wap_mms_msg_submit_and_receive(Name, URL, Message, ReceivedMMS); /* MACRO  
(char*, char*, void*, void**) */  
  
// wap_push_msg_get_field  从最近收到的  
//  “推”消息中检索字段  FieldName  的值。  
//  检索到的值存储在参数  ParamName   中。  
int wap_push_msg_get_field(const char *FieldName, const char *ParamName);  
  
// wap_send_sms  函数向指定地址发送一个  SMS  
//  类型的消息。  
int wap_send_sms (const char * List of Arguments, LAST);  
  
// web_add_auto_header  函数是一个服务函数，  
//  它向所有后续  HTTP  请求添加头。  
int web_add_auto_header (const char *Header, const char *Content );  
  
// web_add_cookie  函数可以添加新的  Cookie 。如果  
//  名称和路径与现有  Cookie  匹配，则现有  
// Cookie  被新  Cookie  覆盖。如果已过“过期”  
//   日期，则删除该  Cookie 。  
int web_add_cookie (const char *Cookie);  
  
// web_add_filter  指定下载下一个操作函数中的内容时  
//  要使用的筛选器。  
//  筛选器将包含或排除含有匹配条件的  URL ，  
//  视传递到该函数的  Action  属性  
//  而定。默认  
//  操作为“Action=Exclude ”。  
int web_add_filter ( [Action,]< List of Attributes >, LAST ) ;  
  
// web_add_auto_filter  指定下载随后发生的操作函数的内容  
//  时要使用的筛选器。  
//  调用  web_remove_auto_filter  后，将禁用  
//  该筛选器。筛选器将包含或排除含有匹配条件的  URL ，  
//  视传递到该函数的  Action  属性  
//  而定。默认  
//  操作为“Action=Exclude ”。  
int web_add_auto_filter ( [Action,]< List of Attributes >, LAST);

msnshow

// web_remove_auto_filter  函数可以禁用  
//  上次调用  web_add_auto_filter  时的筛选器设置。  
int web_remove_auto_filter ( char *Id, LAST );  
  
// web_add_header  函数是一个服务函数，  
//  它向下一个  HTTP  请求添加用户定义的头。  
int web_add_header (const char *Header, const char *Content );  
  
// web_cache_cleanup  函数是一个服务函数，  
//  它清除缓存模拟程序中的内容。  
//  如果在“浏览器模拟”选项卡上启用运行时  
//  设置选项“每次循环时模拟一个新用户”，  
//  则该函数会在每次循环开始时  
//   自动调用。  
int web_cache_cleanup();  
  
// web_cleanup_auto_headers  函数是一个  
//  服务函数，它会禁止向后续  HTTP  请求  
//  添加用户定义的头。  
int web_cleanup_auto_headers ( );  
  
// web_cleanup_cookies  函数删除脚本使用的  
//  所有当前存储的  Cookie 。  
int web_cleanup_cookies ( );  
  
// web_concurrent_end  函数可以标记  
//  并发组的结束，并开始并发执行所有注册  
//  为并发的函数（位于函数   
// web_concurrent_start  和  
// web_concurrent_end  之间的函数）。  
//  单击“并发函数”，以查看并发组中可能  
//  包含的函数的列表。  
int web_concurrent_end ( reserved );  
  
// web_concurrent_start  函数可以  
//  标记并发组的开始。组中的所有函数  
//  均并发执行。组的结束由函数   
// web_concurrent_end  标记。在并发组  
//   中可以包含操作函数和几个服务函数。  
//  单击“并发函数”，以查看并发组中可能  
//  包含的函数的列表。  
//   
int web_concurrent_start ( [char * ConcurrentGroupName,] NULL );

msnshow

// web_convert_param  函数将  HTML  文本  
//  转换为纯文本或  URL ，或将纯文本转换为  URL 。  
int web_convert_param (const char *ParamName, [char *SourceString] char *SourceEncoding,  
char *TargetEncoding, LAST);  
  
// web_create_html_param  函数是一个服务  
//  函数，用于在  Web  脚本中关联  HTML  语句。  
//  函数  web_create_html_param  
//  检索重放期间生成的动态信息，然后将  
//  第一次出现的动态信息保存在某个  
//  参数中。  
int web_create_html_param (const char *ParamName, const char *LeftBoundary,    const char  
*RightBoundary );  
  
// web_create_html_param_ex  函数是一个服务  
//  函数，用于在  Web  脚本中关联  HTML  语句。  
//  函数  web_create_html_param_ex  检索重放  
//  期间生成的动态信息，然后将该动态信息保存在  
//  某个参数中。  
int web_create_html_param_ex (const char *ParamName, const char *LeftBoundary,    const char  
*RightBoundary, const char *Instance );  
  
// web_custom_request  函数是一个操作函数，  
//  通过它可以使用任意方法创建自定义  HTTP  请求  
//  或创建正文。默认情况下，VuGen  只为无法  
//  用其他  Web  函数解释的请求生成该函数。  
//   
int web_custom_request (const char *RequestName, <List of Attributes>, [EXTRARES, <List of  
Resource Attributes>,] LAST );  
  
// web_disable_keep_alive  函数是一个服务  
//  函数，它禁用  Keep –Alive HTTP  连接。  
//  默认情况下，KeepAlive  设置处于启用状态。  
int web_disable_keep_alive ( );  
  
// web_dump_cache  保存浏览器缓存。它与  
// web_load_cache  一起使用，以实现  Vuser   
//  持续缓存。脚本始终使用相同的初始缓存运行。  
int web_dump_cache ( const char *Name, const char * fileName, [ const char * Replace], LAST );  
  
// web_enable_keep_alive  函数是一个服务  
//  函数，它启用  Keep –Alive HTTP  连接。  
int web_enable_keep_alive ( );

msnshow

// web_find  函数在  HTML  页中搜索指定的文本字符串。  
int web_find (const char *StepName, <Attributes and Specifications list>, char *searchstring,  
LAST );  
  
// web_get_int_property  函数返回  
//  关于上一个  HTTP  请求的指定信息。  
int web_get_int_property (const int HttpInfoType);  
  
// web_global_verification  函数注册  
//  一个请求，以在所有后续操作函数返回的  
//   网页中搜索指定的文本字符串。这与函数   
// web_reg_find  不同，后者只为下一个  
//  操作函数注册请求。可以搜索页面的正文、  
//  头、HTML  代码或全部内容。  
//   
int web_global_verification (<List of Attributes>, LAST );  
  
//  操作函数  web_image  模拟  
//   鼠标单击由属性定义的图像。  
//  该函数只能在上一个操作  
//  的上下文中执行。  
int web_image (const char *StepName, <List of Attributes>, [EXTRARES, <List of Resource  
Attributes>,] LAST );  
  
// web_image_check  函数可以验证  HTML  页中  
//  包含指定图像。  
int web_image_check(const char *CheckName, <List of Attributes>, <"Alt=alt"|| "Src=src">,  
LAST );  
  
// web_link  函数是一个操作函数，  
//  它模拟鼠标单击由属性定义的  
//  链接。web_link  只能在上一个  
//  操作的上下文中执行。  
int web_link (const char *StepName, <List of Attributes>, [EXTRARES, <List of Resource  
Attributes>,] LAST );  
  
// web_remove_cookie  函数从一个对  Vuser   
//  可用的  Cookie  列表中删除一个  Cookie 。该函数  
//  指定要删除的  Cookie  的名称。  
int web_remove_cookie (const char *Cookie);  
  
// web_load_cache  可以从文件中还原浏览器  
//  缓存。它与  web_dump_cache  一起  
//  使用，以实现  Vuser  持续缓存。脚本

msnshow

//  始终使用相同的初始缓存运行。  
int web_load_cache ( const char *Name, const char * fileName, LAST );  
  
// web_reg_add_cookie  函数注册一个搜索，  
//  在下一个操作函数（如  web_url ）检索到的网页上  
//  搜索一个文本字符串。如果  
//  找到了字符串，将添加  Cookie 。  
int web_reg_add_cookie(const char * cookie, const char * searchstring, LAST );  
  
// web_reg_find  函数注册一个请求，以  
//  在下一个操作函数（如  web_url ）检索到  
//  的网页上搜索一个文本字符串。  
int web_reg_find (const char *attribute_list, LAST);  
  
// web_reg_save_param  是一个注册类型  
//  的函数。它注册一个请求，以在检索到的  
//   网页中查找并保存一个文本字符串。只有  
//  在执行了下一个操作函数（如  web_url ）后  
//  才会执行该操作。  
int web_reg_save_param (const char *ParamName, <List of Attributes>, LAST);  
  
// web_remove_auto_header  函数是一个服务  
//  函数，它停止向后续  HTTP  请求添加特定的用户  
//  定义头。该函数将取消由  web_add_auto_header   
//  启动的指定头的自动头生成。  
//   
int web_remove_auto_header (const char *Header, char *Implicit, LAST);  
  
// web_revert_auto_header  函数是一个服务  
//  函数，它停止向后续  HTTP  请求添加特定的用户  
//  定义头。该函数将取消由  web_add_auto_header   
//  启动的指定头的自动头生成。它不断生成隐性头，  
//  如同不曾调用过函数  web_add_auto_header  
//  或  web_remove_auto_header  一样。  
int web_revert_auto_header (char *Header);  
  
// web_report_data_point  函数在脚本中  
//  定义要包括在测试结果中的数据点。最常见的  
//  数据点是步骤超时，它表明上一个步骤是否超时。  
//   
int web_report_data_point ( const char * EventType, const char * EventName , const char *  
DataPointName , LAST );  
  
// web_save_header  函数将所有随后

msnshow

//  发生的操作函数的主  URL  的请求和  
//  响应头保存在参数  param   中。每个头由  
//  “\r\n ”（或仅“\n ”）分隔。每个新的  
//  请求头将替换参数的当前值。  
int web_save_header (const char *type, const char *param );  
  
// web_save_param_length  创建名为  
//  “<Param>_Length ”的新参数（如果尚无该参数），  
//  并将  Param   的长度保存在参数“<Param>_Length ”  
//   中。该长度采用十六进制格式。  
int web_save_param_length( const char *Param, LAST );  
  
// web_save_timestamp_param  保存当前  
//  时间戳。在某些应用中，VuGen  用一个参数  
//  替换脚本中的所有非空时间戳。为了保存  
//  该参数的值，VuGen   自动生成对  
// web_save_timestamp_param   的调用。  
//  保存的值是自  1970  年  1  月  1   日午夜  
//  开始的毫秒数。  
int web_save_timestamp_param( const char * tmstampParam, LAST );  
  
// web_set_certificate  指定一个证书在  
//  证书列表中的编号。然后，只要某个安全的   
// Web  服务器需要客户端提供证书，就使用  
//  指定的证书。  
int web_set_certificate (const char *CertificateNumber);  
  
// web_set_certificate_ex  设置证书  
//  和关键文件属性，如位置、类型和密码。  
//  该信息用于需要证书的HTTPS  请求。  
//  所有参数都是以  null  终止的字符串。  
//  关键字不区分大小写；但属于关键字  
//  的值是区分大小写的。关键字  
//   
//  值的开头和末尾不允许出现  
//  空格。注意，只有使用  Internet Explorer  
//  时才录制该函数。  
int web_set_certificate_ex (const char *option_list, LAST);  
  
// web_set_connections_limit  函数是  
//  一个服务函数，它设置脚本执行期间可以行  
//   同时运的最大请求数。  
//  在加载页面资源或加载框架集页面  
//   中的框架等情形下，会发出

msnshow

//  多个请求。任何  Vuser  的默认限制为  
//  可以同时发出四个请求。  
int web_set_connections_limit (const char *Limit );  
  
// web_set_max_html_param_len  函数是  
//  一个服务函数，用于关联  HTML  语句。  
//  仅当启用“在录制过程中关联”时  
//  才录制该函数（请参阅  VuGen  的录制选项）。  
int web_set_max_html_param_len (const char *length );  
  
// web_set_max_retries  函数设置操作的  
//  最大重试次数。当发生错误时，对于  HTTP   
//  响应消息  500-599  和网络  API  错误  
//  （HttpSendRequest  等），会尝试进行  
//  重试。对于超时或函数参数错误，不尝试  
//  进行重试。  
int web_set_max_retries (const char *MaxRetries );  
  
// web_set_option  函数设置  Web  选项。  
//  它是一个服务函数，影响其后的所有函数，  
//  直到指定了新值。vuser_init  部分  
//  结束运行时，将保存当前选项值。  
//  在每次循环开始之前，这些值将还原为  
//  保存的值。  
int web_set_option (const char *OptionID, const char * OptionValue, LAST );  
  
// web_set_proxy  函数是一个服务函数，  
//  它指定将所有后续  HTTP  请求定向  
//  到指定的代理服务器。要直接向服务器  
//  提交  HTTP  请求（即不使用代理  
//  服务器），请使用函数  web_set_proxy   
//  传递一个空字符串  ("")  作为参数。  
int web_set_proxy (const char *proxy_host:port );  
  
// web_set_proxy_bypass  函数是一个服务函数，  
//  它指定要直接访问的  URL  的列表，该访问会避开  
//  代理服务器。可以在避开的  URL  列表中包含  <local> ，  
//   以使所有本地主机（如  Intranet  服务器）  
//  都避开代理服务器。  
int web_set_proxy_bypass (const char *bypass1..n );  
  
// web_set_proxy_bypass_local  函数是  
//  一个服务函数，它指定代理服务器是否应  
//  避开本地  (Intranet)  地址。该函数会覆盖

msnshow

//  运行时设置代理选项“对本地  &#40;intranet)  
//  地址不使用代理服务器”。如果代理避开  
//  字符串包含  &#60;local&#62; ，则该函数  
//  和  UI  复选框都将没有以下效果：将  
//  始终避开本地地址。  
int web_set_proxy_bypass_local &#40; const char *no_local );  
  
// web_set_secure_proxy  函数是一个服务函数，  
//  它指定将所有后续  HTTP&#83;  请求  
//  定向到指定的安全代理服务器。  
int web_set_secure_proxy &#40;const char *secure_proxy_host_port );  
  
// web_set_sockets_option  函数配置  
//  客户端上的套接字选项。对于启用或禁用  
//  某项功能（如  TRACE_&#83;&#83;L_IO ）的选项，  
//  请指定“1”以启用，指定“0 ”以禁用。  
//   以下列表显示了支持的选项：  
int web_set_sockets_option&#40; const char *option, const char * value );  
  
// web_set_timeout  函数是一个服务函数，它  
//  指定  CONNECT 、RECEIVE  或  &#83;TEP  操作完成  
//  之前等待的最长时间。  
int web_set_timeout &#40;const char *Action, const char *TimeOut );  
  
// web_set_user  函数是一个服务函数，它  
//  指定  Web  服务器或代理服务器的登录字符串  
//  和密码。如果多个代理服务器需要身份验证，  
//  可以多次调用该函数。web_set_user  
//  会覆盖运行时代理身份验证的用户名和密码  
//  设置。  
int web_set_user &#40;const char *username, const char *password, const char *host:port );  
  
// web_sjis_to_euc_param  函数将一个  &#83;JI&#83;  编码的  
//   以  null  终止的字符串转换为  EUC  编码的字符串，并将它  
//  赋给参数。可以使用函数  lr_eval_string  
//  确定参数的值。  
int web_sjis_to_euc_param &#40;LPC&#83;TR param_name, LPC&#83;TR param_value_in_&#83;JI&#83;);  
  
// web_submit_data  函数是一个操作函数，  
//  它执行“无条件的”或“无上下文的”表单  
//  提交。通过它可以生成  GET  和  PO&#83;T  
//  请求，如同由  HTML  表单生成的请求。执行该请求  
//  不需要有表单上下文。  
int web_submit_data &#40; const char *&#83;tepName, &#60;List of Attributes&#62;, ITEMDATA, &#60;List of data&#62;,[ EXTRARE&#83;, &#60;List of Resource Attributes&#62;,] LA&#83;T );

msnshow

// web_submit_form  函数是一个操作函数，它  
//  可以提交表单。函数  web_submit_form  只能在上一  
//  操作的上下文中执行。  
int web_submit_form (const char *StepName, <List of Attributes>, <List of Hidden Fields>,  
ITEMDATA, <List of Data Fields>, [ EXTRARES, <List of Resource Attributes>,] LAST );  
  
//  通过  web_switch_net_layer  函数，可以在  
//  要重放的网络层间切换。通过它可以在同一  
//  脚本中混用直接的  HTTP  和  WSP  调用。目前，  
//  该函数只影响  WAP Vuser 。  
int web_switch_net_layer (const char *NetName);  
  
// web_url  函数是一个操作函数，它可以加载  
//  指定的网页（GET  请求）。函数  web_url  
//  可以加载  URL  属性指定的  URL 。函数  web_url  
//  不需要上下文。  
  int web_url (const char *Name, const char * url, <List of Attributes>, [EXTRARES, <List of  
Resource Attributes>,] LAST );  
  
// web_browser  操作函数直接在打开的  
//  浏览器上执行操作。  
int web_browser (const char *stepName, [const char *snapShot,] [DESCRIPTION, const char  
*browser,] ACTION, const char *userAction, LAST );  
  
// web_button  操作函数模拟用户单击按钮。  
int web_button (const char *stepName, [const char *snapShot,] DESCRIPTION, [const char  
*type,] [const char *tag,] [const char *arg1, … const char *argn,] LAST );  
  
// web_check_box  操作函数选择或清除  
//  复选框。如果  setOnOff  为“Set=ON”，则选中复选框。  
//  如果  setOnOff  为“Set=OFF”，则清除复选框。  
int web_check_box (const char *stepName, [const char *snapShot,] DESCRIPTION, const char  
*arg1, … const char *argn, ACTION, const char *setOnOff, LAST );  
  
// web_edit_field  函数在文本或密码输入元素  
//   中输入  setValue 。  
int web_edit_field (const char *stepName, [const char *snapShot,] DESCRIPTION, [const char  
*type,] [const char *arg1, … const char *argn,] ACTION, const char *setValue, LAST );  
  
//  永远不录制  web_eval_java_script 。  
//  可以在脚本中添加该函数，以处理没有  
//  标准解决方案的情况。该函数有三种