LoadRunner函数大全之中文解释

msnshow

//  用法，语法各不相同。请勿混淆不同语法  
//  的参数。请勿在语法  1  或语法  2  中使用   
// PrintProperties ，勿在语法  2  或语法  3   
//   中使用  script ，以及勿在语法  1  或语法  3   中使用  
// Expression  和  SaveExpressionResult 。  
int web_eval_java_script ( const char *stepName, const char *script, [DESCRIPTION, const char  
*arg1, …, const char *argn,] LAST );  
  
// web_file  在形如  <INPUT TYPE=FILE NAME= ”Name ”>  
//  的元素中输入文件名  SetPath 。  
int web_file ( const char *StepName, DESCRIPTION, [<List of attributes>], ACTION, const char  
* SetPath, LAST );  
  
// web_image_link  操作函数模拟用户  
//  单击图像（该图像是超文本链接）。  
int web_image_link (const char *stepName, [const char *snapShot,] DESCRIPTION, const char  
*arg1, … const char *argn, [ACTION, const char *clickCoordinates,] LAST );  
  
// web_image_submit  操作函数模拟用户  
//  单击类型为“image ”的输入元素。  
int web_image_submit (const char *stepName, [const char *snapShot,] DESCRIPTION, const  
char *arg1, … const char *argn, ACTION, const char *clickCoordinates, LAST );  
  
// web_list  函数模拟用户在列表框  
//   中选择一项。选择项可以通过  
//  选择项的文本或其位置识别。  
//  第一个选项的位置为  1 。  
int web_list (const char *stepName, [const char *snapShot,] DESCRIPTION, const char *type,  
[const char *arg1, … const char *argn,] ACTION, const char *selectAction, [const char  
*ordinalSelectAction,] LAST );  
  
// web_map_area  函数可以激活客户端映射的一个  
//  区域。无论该区域如何激活，都将录制该函数。通常，  
//  用户单击一个区域会激活该区域。  
int web_map_area (const char *stepName, [const char *snapShot,] DESCRIPTION, const char  
*mapName, const char *arg1, … const char *argn, LAST );  
  
// web_radio_group  操作函数模拟用户  
//  在单选按钮组中选择一个按钮。  
int web_radio_group (const char *stepName, [const char *snapShot,] DESCRIPTION, const char  
*name, const char *arg1, … const char *argn, ACTION, const char *selection, LAST );  
  
// web_reg_dialog  服务函数可以注册  
// Java  脚本使用的信息。

msnshow

int web_reg_dialog (DESCRIPTION, const char *type, [const char *message,][const char  
*browser,] ACTION, const char *userAction, LAST );  
  
// web_static_image  模拟用户单击图像。  
//  如果  IMG  元素被具有  HREF  属性的  <A>  元素  
//   围起，则它是一个链接，该函数无效。在这种  
//  情况下，请使用  web_image_link 。  
int web_static_image ( const char *StepName, DESCRIPTION, <List of attributes>, LAST );  
  
// web_text_area  操作函数在文本区域中输入  setText 。  
int web_text_area (const char *stepName, [const char *snapShot,] DESCRIPTION, const char  
*arg1, … const char *argn, ACTION, const char *setText, LAST );  
  
// web_text_link  操作函数模拟  
//  用户单击超文本链接。  
int web_text_link (const char *stepName, [const char *snapShot,] DESCRIPTION, [const char  
*text, ][const char *arg1, … const char *argn,] LAST );  
  
// lrs_accept_connection  函数从  
//    old_socket  上的挂起连接队列中  
//  取出第一个连接，使用相同属性创建  
//  新的套接字。原来的套接字对于其他  
//  连接仍然可用。  
int lrs_accept_connection ( char *old_socket, char *new_socket );  
  
// lrs_ascii_to_ebcdic  函数可以将二进制  
//  缓冲区数据从  ASCII  格式转换为  EBCDIC  格式。  
//  转换后的缓冲区以  EBCDIC  格式存储在内部缓冲区  
//  （用户缓冲区）中。要检索缓冲区的内容，请使用   
// lrs_get_user_buffer 。要确定缓冲区大小，  
//  请使用  lrs_get_user_buffer_size 。  
char *lrs_ascii_to_ebcdic ( char *s_desc, char *buff, long length );  
  
// lrs_cleanup  函数终止使用  Windows   
// Sockets DLL   （类似于  WSACleanup ）  
//  和系统资源，如释放文件描述符。请检查  
//  返回代码，以验证清理成功。  
int lrs_cleanup ( );  
  
// lrs_close_socket  函数释放指定的  
//  套接字描述符，以关闭套接字。再次引用  
//  该套接字将会导致错误  WSAENOTSOCK 。  
//  如果这是对基础套接字的最后一次引用，  
//  将丢弃相关的命名信息和队列数据。

msnshow

//  注意，对于  TCP 套接字，函数   
// lrs_close_socket  会将所有尚未发送  
//  的数据发送出去。  
int lrs_close_socket ( char *s_desc );  
  
// lrs_create_socket  函数初始化一个套接字。  
//  它执行  socket  命令，打开新的套接字。  
//  如果提供了  LocalHost  参数，它会执行  
// bind  命令，以命名该套接字。如果提供了  peer  参数，  
//  它会执行  connect  命令，以建立与对等端的  
//  连接。如果提供了  backlog  参数，它  
//  会执行  listen  命令侦听该套接字。  
int lrs_create_socket ( char *s_desc, char *type, [ char* LocalHost,] [char* peer,] [char *backlog,]  
LrsLastArg );  
  
// lrs_decimal_to_hex_string  函数可以将整数  
//  转换为十六进制字符串。例如，如果字符串为  
// 4 ，则该函数将它转换为  \x04 。  
char*    lrs_decimal_to_hex_string( char* s_desc, char* buf, long length);  
  
// lrs_disable_socket  函数禁止套接字的一项  
//  操作。可以禁止所有的发送和/或接收操作。  
int lrs_disable_socket ( char *s_desc, int operation );  
  
// lrs_ebcdic_to_ascii  函数将二进制缓冲区  
//  数据从  EBCDIC  格式转换为  ASCII  格式。转换后  
//  的缓冲区以  ASCII  格式存储在内部缓冲区  
//  （用户缓冲区）中。要检索缓冲区的内容，  
//  请使用  lrs_get_user_buffer 。要确定缓冲区  
//  的大小，请使用  lrs_get_user_buffer_size 。  
char *lrs_ebcdic_to_ascii ( char *s_desc, char *buff, long length );  
  
// lrs_exclude_socket  函数排除指定  
//  套接字的所有操作。脚本中从该函数开始  
//   向后的所有使用该指定套接字的函数都  
//  将被忽略。建议将该函数放在脚本的   
// vuser_init  部分。排除对脚本所有  
//  部分中的套接字函数都有效。  
//   
int lrs_exclude_socket ( char *s_desc );  
  
// lrs_free_buffer  函数释放为指定缓冲区分配的  
//   内存。内存是在调用函数  lrs_get_buffer_by_name   
//  或  lrs_get_last_received_buffer  时

msnshow

//  分配的。  
int lrs_free_buffer ( char *buffer );  
  
//  对于指定的缓冲区描述符，函数   
// lrs_get_buffer_by_name  获取  
//  二进制缓冲区以及数据二进制表示的长度。  
//  注意，数据缓冲区不是以  NULL  终止的。  
int lrs_get_buffer_by_name ( char *buf_desc, char **data, int *size );  
  
// lrs_get_last_received_buffer  函数获取  
//  套接字上最后收到的缓冲区及其大小。注意，该  
//  函数返回数据二进制表示的长度。数据缓冲区  
//  不是以  NULL  终止的。  
int lrs_get_last_received_buffer ( char *s_desc, char **data, int *size );  
  
// lrs_get_last_received_buffer_size  函数  
//  获取套接字  s_desc  上最后收到的缓冲区的  
//  大小。注意，该函数返回数据二进制表示的  
//  长度。  
int lrs_get_last_received_buffer_size ( char *s_desc );  
  
// lrs_get_received_buffer  函数检索  
//  最后一次调用  lrs_receive 、lrs_receive_ex  
//  或  lrs_length_receive  收到的缓冲区的全部  
//  或其一部分。请指定要检索的数据的  
//  偏移量和长度。  
char *lrs_get_received_buffer ( char *s_desc, int offset, int length, char *encoding );  
  
// lrs_get_static_buffer  函数检索  
//  来自数据文件的静态缓冲区或其一部分。  
//  请指定缓冲区及要检索的数据的偏移量  
//  和长度。该缓冲区在发生任何参数替换后  
//  返回。  
char *lrs_get_static_buffer ( char *s_desc, char *buffer, int offset, int length, char *encoding );  
  
// lrs_get_socket_attrib  函数检索  
//  指定的套接字属性。通过它可以获取有关  
//  套接字的信息。只能从绑定或连接到某个  
//  套接字的套接字检索属性。要将一个套接字  
//  绑定到现有套接字，请使用  lrs_create_socket( …LocalPort=…) 。  
//  要连接到一个套接字，请使用  lrs_create_socket( …RemoteHost= …) 。  
char *lrs_get_socket_attrib ( char *s_desc , int attribute );  
  
// lrs_get_socket_handler  函数检索指定

msnshow

//  套接字的套接字句柄。检索到套接字句柄后，  
//  可以在后续函数中使用。  
int lrs_get_socket_handler ( char *s_desc );  
  
// lrs_get_user_buffer  函数检索指定套接字的  
//  用户数据缓冲区的内容。  
char *lrs_get_user_buffer ( char *s_desc );  
  
// lrs_get_user_buffer_size  函数检索指定套接字的  
//  用户数据缓冲区的大小。  
long lrs_get_user_buffer_size ( char *s_desc );  
  
// lrs_hex_string_to_int  将一个  
//  十六进制字符串转换为整数。请指定  
//  指向包含要转换字符串的缓冲区的指针  
//  及要转换字符串的长度。该函数将转换  
//  字符串并赋值给整型引用。  
int lrs_hex_string_to_int ( char* buff, long length, int* mpiOutput );  
  
// lrs_length_receive  函数将指定长度的  
//  数据从  sock_descriptor  读入缓冲区。  
//  长度位于接收到的缓冲区自身内部。用户  
//  必须知道该长度值位于缓冲区内何处  
//  （除非选择了  RecieveOption_None  
//  选项），其位置通过参数  location_option   
//  和  locators  指定。lrs_length_receive   
//  首先获得长度值（下面称为  length ），  
//  再将  length  个字符从  socket_descriptor   
//  读入缓冲区。  
int lrs_length_receive(char *socket_descriptor, char *buffer, int location_option,    [char* locators],  
[char* additional_params], LrsLastArg );  
  
// lrs_length_send  函数将指定  
//  长度的数据从  sock_descriptor  于  
//  写入  buffer 。它用发送参数化数据，  
//  每次调用该函数时数据的长度可以  
//  不同。使用  lrs_length_send  可以  
//  不必每次计算长度，因为  Vugen   
                                             
//   自动将正确的数据长度写入由参数
// locator  和  location_option   
//  指定的字段。  
int lrs_length_send(char *socket_descriptor, char *buffer, int location_option,    [char* locators],  
[char* additional_params], LrsLastArg );

msnshow

// lrs_receive  函数从数据报或流式套接字  
//  读取输入数据。如果套接字上没有输入  
//  数据，lrs_receive  将等待数据到达，  
//  除非套接字是非分块套接字。  
int lrs_receive ( char *s_desc, char *bufindex, [char *flags], LrsLastArg );  
  
// lrs_receive_ex  函数从数据报或  
//  流式套接字的输入数据中读取指定数目  
//  的字节。除了可以指定要接收字节  
//  数的功能外，它与函数  lrs_receive  
//  等价。  
int lrs_receive_ex ( char *s_desc, char *bufindex, [char *flags,] [char *size,]            [char  
*terminator,] [char *mismatch,] [char *RecordingSize,]          LrsLastArg );  
  
// lrs_save_param  函数将数据从缓冲区保存  
//  到参数中。该函数用于关联或链接脚本中的  
//  语句。  
int lrs_save_param ( char *s_desc,char *buf_desc, char *param_name, int offset, int param_len);  
  
// lrs_save_param_ex  函数将缓冲区或  
//  缓冲区的一部分保存到参数中。参数  type   
//  指定要保存的缓冲区数据的类型：用户缓冲区、  
//  录制缓冲区或最后接收的缓冲区。该函数  
//  会覆盖用户数据区。  
int lrs_save_param_ex ( char *s_desc, char *type, char *buff, int offset, int length, char *encoding,  
char *param );  
  
// lrs_save_searched_string  函数将  
//  缓冲区的一部分保存到参数中。该函数用于  
//  关联或链接脚本中的语句。该函数扩展了   
// lrs_save_param  的功能。  
int lrs_save_searched_string (char* s_desc, char* buf_desc, char* param_name,    char*  
left_boundary, char* right_boundary, int ordinal, int offset,    int param_len );  
  
// lrs_send  函数将输出数据写到已  
//  连接的数据报或流式套接字。如果不能  
//  成功发送缓冲区中的所有数据，将重复  
//  尝试，直到发送超时。如果无法为数据  
//  找到可写的套接字，该函数将不断查找  
//  套接字，直到发送超时。默认情况下，  
//  发送超时值为  10  秒。可以使用  
// lrs_set_send_timeout  修改超时值。  
//  注意，lrs_send  成功完成并不表示  
//  数据已成功传递。

msnshow

int lrs_send ( char *s_desc, char *buf_desc, [char *target], [char *flags,] LrsLastArg );  
  
// lrs_set_accept_timeout  函数设置  
//  服务器在检测到可读套接字  (select)   
//  并完成关联  (accept)  之前等待的时间。  
//  如果套接字当前正在侦听，并且  
//  收到了传入的连接请求，它将被标记为  
//  可读。一旦套接字被标记为可读，  
//  就可以保证完成  accept ，不会阻塞。  
//  可以为超时值指定秒数和毫秒  
//  数。如果套接字在超时时间间隔内  
//  未被接受，则脚本执行将终止。  
//  默认的超时值为  10  秒。如果您发现  
//  默认时间不够，请做相应  
//  修改。  
void lrs_set_accept_timeout ( long seconds, long u_sec );  
  
// lrs_set_connect_timeout  函数设置连接  
//  到套接字的超时值。请将这个可编程（非录制）  
//  的函数插到连接命令  lrs_create_socket   
//  之前。  
void lrs_set_connect_timeout ( long seconds, long u_sec );  
  
// lrs_set_receive_option  函数为   
// lrs_receive  设置套接字接收选项。Option   
//  指明在出现不匹配或检测到终止字符串时，  
//  停止接收套接字信息。注意，该选项不会应用  
//  于通过  lrs_receive_ex  进行的任何接收  
//  操作。该函数设置的选项应用于该函数之后  
//   出现的所有  lrs_receive ，除非该选项被某个  
//  后续  lrs_set_receive_option  调用重置。  
int lrs_set_receive_option ( int option, int value, [char * terminator] );  
  
// lrs_set_recv_timeout  函数设置  Vugen  从套接字  
//  接收到期望数据之前等待的时间段。  
void lrs_set_recv_timeout ( long sec, long u_sec );  
  
// lrs_set_recv_timeout2  函数设置在套接字  
//  上接收数据的超时限制。当  lrs_receive  接收  
//  到数据缓冲区后，它将其大小与期望数据进行  
//   比较。如果缓冲区大小不匹配，它将执行  
//  更多的循环，重新读取输入套接字数据，  
//  直到达到限制值  timeout2 。可以在  
//  完整日志跟踪中查看这些循环。

msnshow

void lrs_set_recv_timeout2( long sec, long u_sec );  
  
// lrs_set_send_buffer  函数指定下次调用  
// lrs_send  时要发送的缓冲区。将发送  
// lrs_set_send_buffer   中指定的缓冲区，  
//  而不是函数  lrs_send  中指定的缓冲区。  
int lrs_set_send_buffer ( char *s_desc, char *buffer, int size );  
  
// lrs_set_send_timeout  函数设置向可写  
//  套接字发送数据的超时值。可以为超时值指定  
//  秒数和毫秒数。  
void lrs_set_send_timeout ( long sec, long u_sec );  
  
// lrs_set_socket_handler  函数为指定  
//  套接字设置套接字句柄。  
int lrs_set_socket_handler ( char *s_desc, int handler );  
  
// lrs_set_socket_options  函数为指定  
//  缓冲区设置一个选项。  
int lrs_set_socket_options ( char *s_desc, int option, char *option_value );  
  
// lrs_startup  函数初始化  Windows  
// Sockets DLL 。它指定可用于本应用的最高   
// Windows Sockets  版本。该函数  
//  必须在所有其他  LRS  函数之前执行。  
//  通常，它出现于脚本的  vuser_init  
//  部分。如果该函数失败，执行  
//  将立即终止。  
int lrs_startup ( int version );  
  
// soap_request  函数执行一个  SOAP  
//  请求。它向指定的  URL  发送  SOAP  包，  
//  并接收服务器响应。  
int soap_request (const char *StepName, URL, <XMLEnvelope>, LAST]);  
  
// web_service_call  函数调用  Web  服务。  
int web_service_call (const char *StepName, URL, <List of specifications>,  
[BEGIN_ARGUMENTS, Arguments, END_ARGUMENTS,] [BEGIN_RESULT, Results,  
END_RESULT] LAST );  
  
// lr_xml_get_values  函数在  XML   
//  输入字符串  XML   中查询匹配查询条件的值。  
int lr_xml_get_values ( <List of specifications> [, <List of optional specifications> ] [, LAST]);

msnshow

// lr_xml_set_values  函数在  XML   
//  输入字符串  XML   中查询匹配查询条件的值，  
//  并将  Value  或  ValueParam  设置为  
//  查询匹配的元素的值。  
int lr_xml_set_values ( <List of specifications> [, <List of optional specifications> ] [, LAST]);  
  
// lr_xml_extract  函数查询  XML  输入字符串  
// XML ，并提取  XML  树中匹配查询条件  
//  的片段。输出参数  XMLFragmentParam  
//  包含提取的片段。  
int lr_xml_extract ( <List of specifications> [, <List of optional specifications> ] [, LAST]);  
  
// lr_xml_delete  函数在  XML  输入字符串  
// XML   中进行查询，并删除与查询条件匹配  
//  的  XML  树片段。可以通过在  XML  查询  
//   中指定元素名称或其属性来删除  
//  元素。输出参数  ResultParam  包含  
//  删除后经修改的  XML  字符串（使用  
//  源文档编码）。  
int lr_xml_delete ( <List of specifications> [, <List of optional specifications> ] [, LAST]);  
  
// lr_xml_replace  函数在  XML  输入字符串  XML   中查询与查询条件匹配的值，并  用  XmlFragment  或  XmlFragmentParam将它们替换为与查询匹配的元素的值。  可以通过在  XML  查询中指定元素名称 或属性来替换元素。结果字符串  放在  ResultParam   中（使用源文档  。 编码）
int lr_xml_replace ( <List of specifications> [, <List of optional specifications> ] [, LAST]);  
  
// lr_xml_insert  函数在  XML  输入字符串  
// XML   中查询与查询条件匹配的值。然后，它在  
//  查询返回的  XML  字符串中的一个或多个位置  
//  处插入  XmlFragment  或  XmlFragmentParam 。  
int lr_xml_insert ( <List of specifications> [, <List of optional specifications> ] [, LAST]);  
  
// lr_xml_find  函数在  XML  输入字符串  XML   中   查询与条件（Value  或  ValueParam ）查询的值，  并返回出现次数。如果  SelectAll  为“no ”，  则  lr_xml_find  返回  1  或  0 。  
int lr_xml_find ( <List of specifications> [, <List of optional specifications> ] [, LAST]);  
  
//  函数  lr_xml_transform  使用样式表中的可扩展样式表语言  (XSL)  规范转换  XML  输入字符串  XML ，并将作为结果产生 的格式化数据保存在  ResultParam   中  （使用源文档编码）。  
int lr_xml_transform ( <List of specifications> ]);

pconline_qa

不错，很方便