LoadRunner通用函数详解(中文)

脚本运行相关lr_get_vuser_ip作用获取虚拟用户IP。

返回值成功，返回虚拟用户的IP指针；失败，返回NULL.参数无例子Action(){char *ip;ip = lr_get_vuser_ip();if (ip)lr_output_message("The IP address is %s", ip);elselr_output_message("IP spoofing disabled");}lr_vuser_status_message作用该函数将消息发送到消息到vuser状态区域，同时还将该字符串发送到vuser日志返回值成功，0；失败，-1说明事务名称非法或者没有调用lr_start_transaction参数（格式化输出）例子lr_vuser_status_message( "We are on iteration #%s", lr_eval_string( "{iteration}" ) );lr_continue_on_error作用指定错误处理的方法返回值无参数（int value）0：取消出错继续执行设置1：发生错误继续运行脚本2：发生错误跳至下个Action运行3：发生错误跳至下一迭代来运行4：发生错误结束当前用户例子//对于夜间执行的场景（一般会打开Continue on error选项）。

一些非关键业务，则需要通过lr_continue_on_error (1)开启Continue on error选项，这样即使遇到错误也不会影响脚本的继续执行。

但是对于关键业务，就需要关闭该项，使一些关键业务在出错时能够停止执行。

//反之，如果在Run-time Settings中没有勾选Continue on error项，则应该通过组合使用lr_continue_on_error (1)与lr_continue_on_error (0)来使一些非关键业务发生错误后继续执行Action(){…………lr_continue_on_error (0); //下面是一些重要事务代码，因此关闭出错继续执行设置…………lr_continue_on_error(1); //后面是一些非关键事务代码，例如下载一些图片文件，因//此开启出错继续执行参数设置。

…………return 0;}lr_convert_string_encoding作用将字符串转换为不同的编码返回值成功，0；失败，-1；参数含有4个参数sourceString：被转换的源字符串。

fromEncoding：转换前的字符编码。

toEncoding：要转换成为的字符编码。

paramName：转换后的目标字符串，即存放转换后的字符串。

例子Action(){int rc = 0;unsigned long converted_buffer_size_unicode = 0;char *converted_buffer_unicode = NULL;rc = lr_convert_string_encoding("Hello world",LR_ENC_SYSTEM_LOCALE,LR_ENC_UNICODE,"stringInUnicode");if(rc < 0){lr_output_message("字符编码转换失败");}return 0;}lr_disable_ip_spoofing&lr_enable_ip_spoofing作用在运行脚本中开启和关闭IP欺骗返回值成功，0；失败，-1；例子：参数无例子lr_enable_ip_spoofing();....lr_disable_ip_spoofing();lr_abort作用终止脚本的运行。

在9.5的帮助文档中是这样描述的:如果终止了action里脚本的运行，将会直接运行vuser_end中的脚本。

当你用这个函数结束脚本的运行，它的状态将会是stop，这里应该指的是在controller中运行后在analysis中的状态我们使用该函数可以手动来终止脚本的运行，试了一下该函数得到以下结论：如果在vuser_init中运行此函数，将会直接终止，不在运行之后的函数，包括aciton和vus er_end;如果有新建的action,在action中或新建的action中使用该函数，都将直接终止运行，直接运行vuser_end里的脚本。

返回值无参数无例子int status;status = web_url("Login","URL=https:////login.asp?user=(username)&session={ssid}","RecContentType=text/html", LAST);if (status == LR_FAIL) {lr_error_message("Error: %s", "Unable to login to secure computing");lr_abort();}lr_decrypt作用解密字符串，该功能主要是对于脚本中出现的密码等不想外泄，现将密码使用lr加密，在脚本中使用该函数解密返回值成功，指向解码字符串失败，NULL参数需要解密的字符串例子connect_server("199.203.78.170","9000"/*version=110*/,"module=e:\\appsnca\\fnd\\7.5\\forms\\us\\fndscsgn userid=applsyspub/pub@vision fndnam=apps");lr_think_time(7);set_window( "Oracle Applications");edit_set("ERNAME.0", "OPERATIONS");edit_set("FNDSCSGN.SIGNON.PASSWORD.0",lr_decrypt("38620da61ca1093e7aa7ec")); button_press("FNDSCSGN.SIGNON.CONNECT_BUTTON");lr_get_host_name作用获取运行脚本的主机名返回值成功，返回运行脚本的主机名称，返回值为指针类型，只可读取不可修改。

失败，NULL参数无例子Action(){char * my_host;my_host = lr_get_host_name( );lr_output_message("%s", my_host);}lr_get_master_host_name作用返回运行脚本的Controller的主机名称，返回值为指针类型，只可读取不可修改。

例子：（注意只有在场景中才能读出主机名称）返回值成功，返回运行脚本的主机名称，返回值为指针类型，只可读取不可修改。

失败，NULL参数无例子Action(){char * controller_host;controller_host = lr_get_master_host_name( );lr_output_message("%s",controller_host);}lr_exit作用从脚本、action、迭代等退出返回值无参数两个参数(int continuation_option, int exit_status);第一个参数为Continuation Options，状态见下图，用来执行调用该函数的后续操作第二个为执行结果，LR_PASS|LR_FAIL|LR_AUTO例子vuser_init() {int status = ftp_logon("FTP", "URL=ftp://user:****************.com", "LocalAddr=ca_server:21", "ClientCert=/ca/pem/","ClientKey=/ca/pem/key/", "ClientPassword=@3#$8800cvd","CertificateAuthority=/ca/", "SSLVersion=SSL2", LAST );if (status == LR_FAIL) {lr_error_message ("ftp login failed");lr_exit(LR_EXIT_VUSER, LR_FAIL);}return(0);}lr_whoami作用返回关于Vuser执行脚本的信息，返回当前运行的vuser ID、运行脚本的组名称以及场景ID 返回值无参数（用户指针，组指针，场景方案及会话ID号指针），三个参数都需要先注册，第一和第三个参数，如果不想要可以使用null代替（不想保存第一和第三个项），但不可缺少。

注意，组参数是内部定义的指针常量，不可修改。

Action(){int id, scid;char *vuser_group;lr_whoami(&id, &vuser_group, &scid);lr_message( "Group: %s, vuser id: %d, scenario id %d",vuser_group, id, scid);}数据库相关lr_db_connect数据库连接操作（使用oracle 、SQL、及windows认证格式略有不同）lr_db_dataset_action数据库执行操作（RESET、REMOVE、PRINT）lr_db_disconnect数据库断开连接lr_db_executeSQLStatement数据库执行操作（SQL语句操作）lr_db_getValue检索lr_db_executeSQLStatement查询出的数据数据库案例：Action(){int NumRows=0;int i=1;//建立数据库连接lr_db_connect("StepName=DatabaseConnection","ConnectionString=Provider=OraOLEDB.Oracle.1;Password = test ;Persist Security Info=True; User ID = test ; Data Source = betadb ; Server = 172.19.188.191","ConnectionName=InvDatabaseConnection","ConnectionType=OLEDB",LAST);//执行SQL语句NumRows = lr_db_executeSQLStatement("StepName=PerformQuery","ConnectionName=InvDatabaseConnection","SQLStatement=SELECT cons_no,cons_id FROM c_cons where rownum<10","DatasetName=MyDataset",LAST);lr_output_message("The query returned %d rows.", NumRows);//打印出结果lr_db_dataset_action("StepName=PrintDataset","DatasetName=MyDataset","Action=PRINT",LAST);//利用循环检索数据值while (i<10) {lr_db_getvalue("StepName=GetValue","DatasetName=MyDataset","Column=CONS_NO","Row=next","OutParam=MyOutputParam",LAST);lr_output_message("The value is: %s", lr_eval_string("{MyOutputParam}") );i=i+1; }//释放结果lr_db_dataset_action("StepName=RemoveDataset","DatasetName=MyDataset","Action=REMOVE",LAST);//断开数据库连接lr_db_disconnect("StepName=Disconnect","ConnectionName=InvDatabaseConnection",LAST);return 0;}lr_checkpoint作用检查函数，对比实际值和预期值，仅适用于Web Services脚本返回值LR_PASS；LR_FAIL；参数4个参数("StepName=VerifyCheckpoint", //步骤名称，可以设置任意名称，该名称会出现在test树中"ExpectedValue=Joe", //预期值, 可以是具体的value也可以是lr的参数"ActualValue={MyOutputParam}", //实际值，与预期值对比，可以试试value也可以是lr参数"Compare=Equals", //包括5个选项Equals|NotEquals|Contains|StartsWith|EndsWith，等于、不等于、包含、开始、结束等"StopOnValidationError=false",//false失败时脚本是否继续，true失败时退出，另外Continue on Error- runtime setting优先于该项设置LAST );例子int i=1;lr_db_executeSQLStatement("StepName=PerformQuery","ConnectionName=db1","SQLStatement=SELECT dbo.Customer.CustID, dbo.Customer.FirstName, stName FROM dbo.Customer","DatasetName=MyDataset",LAST );while (i<4) {lr_db_getvalue("StepName=GetValue","DatasetName=MyDataset","Column=FirstName","Row=next","OutParam=MyOutputParam",LAST );lr_output_message("The value is: %s", lr_eval_string("{MyOutputParam}") );lr_checkpoint("StepName=VerifyCheckpoint","ExpectedValue=Joe","ActualValue={MyOutputParam}","Compare=Equals","StopOnValidationError=false",LAST );i=i+1;}事务及事务实例相关操作lr_rendezvous作用创建集合点。