loadrunner常用的函数

一：通用函数
LoadRunner的通用函数以lr为前缀，可以在任何协议中使用。可以如下分类：
信息相关的函数：
lr_error_message lr_output_message
事务函数：
lr_start_transaction
lr_end_transaction
运行时函数：
lr_think_time
lr_exit
参数相关的函数：
lr_save_datetime lr_advance_param lr_eval_string
lr_save_string lr_get_attrib_string
一些函数的详细解释：
1．lr_error_message
往VuGen的回放日志和Controller的输出窗口发送错误信息，例子：
lr_error_message("string");
2．lr_abort()
中止脚本的执行。如果在Action中使用，就会中止Action的执行，而去执行vuser_end.
3．lr_exit
退出脚本，action或者迭代。
lr_exit(intcontinuation_option, intexit_status);
4．lr_save_string
保存指定的非空字符串到一个参数。
lr_save_string(const char *param_value, const char
*param_name);
5．lr_save_date_time
保存日期和时间到参数中。
lr_save_datetime(const char *format,intoffset,const char
*name);
在lr_save_datetime中使用偏移量
lr_save_datetime(“Tomorrow is %B %d %Y", DATE_NOW+ONE_DAY,
“nextDate");
DATE_NOW+ONE_DAY：当前日期的偏移量
如果现在的时间是：2008年二月27
nextDate中保存的时间为：Tomorrow is二月28 2008
6．lr_advance_param
lr_advance_param (const char *param);
其中参数用双引号，但不用括号。
7．lr_eval_string
lr_eval_string("{parameter_name}");
返回指定参数的当前字符串值。
检索参数值，可以使用来下面的函数打印该输出到输出信息中。
lr_output_message或者lr_error_message
8．lr_get_attrib_string
lr_get_attrib_string (const char *argument);
二．特定协议的函数
这类函数跟录制的协议类型有关系。
Web协议：以web为前缀
lrd是数据库相关的函数，lrs是window socket协议的函数。
web_reg_save_param(const char
*ParamName,LB,RB,ORD,SaveLen,SaveOffset, LAST);
例子：
web_reg_save_param("flight_name", "LB=Select your departure ",
"RB="", LAST);
web_reg_find:
web_reg_find(“Text=Welcome”, SaveCount, LAST);

loadrunner常用的函数如下：
lr_start_transaction 为性能分析标记事务的开始
lr_end_transaction 为性能分析标记事务的结束
lr_rendezvous 在 Vuser 脚本中设置集合点
lr_think_time 暂停 Vuser 脚本中命令之间的执行
lr_end_sub_transaction
标记子事务的结束以便进行性能分析
lr_end_transaction 标记 LoadRunner 事务的结束
Lr_end_transaction("trans1",Lr_auto);
lr_end_transaction_instance
标记事务实例的结束以便进行性能分析
lr_fail_trans_with_error 将打开事务的状态设置为 LR_FAIL
并发送错误消息
lr_get_trans_instance_duration
获取事务实例的持续时间（由它的句柄指定）
lr_get_trans_instance_wasted_time
获取事务实例浪费的时间（由它的句柄指定）
lr_get_transaction_duration
获取事务的持续时间（按事务的名称）
lr_get_transaction_think_time
获取事务的思考时间（按事务的名称）
lr_get_transaction_wasted_time
获取事务浪费的时间（按事务的名称）
lr_resume_transaction 继续收集事务数据以便进行性能分析
lr_resume_transaction_instance
继续收集事务实例数据以便进行性能分析
lr_set_transaction_instance_status
设置事务实例的状态
lr_set_transaction_status 设置打开事务的状态
lr_set_transaction_status_by_name
设置事务的状态
lr_start_sub_transaction 标记子事务的开始
lr_start_transaction 标记事务的开始
Lr_start_transaction("trans1");
lr_start_transaction_instance
启动嵌套事务（由它的父事务的句柄指定）
lr_stop_transaction 停止事务数据的收集
lr_stop_transaction_instance
停止事务（由它的句柄指定）数据的收集
lr_wasted_time 消除所有打开事务浪费的时间
lr_get_attrib_double 检索脚本命令行中使用的 double
类型变量
lr_get_attrib_long 检索脚本命令行中使用的 long
类型变量
lr_get_attrib_string 检索脚本命令行中使用的字符串
lr_user_data_point 记录用户定义的数据示例
lr_whoami 将有关 Vuser 脚本的信息返回给 Vuser 脚本
lr_get_host_name 返回执行 Vuser 脚本的主机名
lr_get_master_host_name 返回运行 LoadRunner Controller
的计算机名
lr_eval_string 用参数的当前值替换参数
lr_save_string 将以 NULL 结尾的字符串保存到参数中
lr_save_var 将变长字符串保存到参数中
lr_save_datetime 将当前日期和时间保存到参数中
lr _advance_param 前进到下一个可用参数
lr _decrypt 解密已编码的字符串
lr_eval_string_ext 检索指向包含参数数据的缓冲区的指针
lr_eval_string_ext_free 释放由 lr_eval_string_ext
分配的指针
lr_save_searched_string
在缓冲区中搜索字符串实例，并相对于该字符串实例，将该缓冲区的一部分保存到参数中
lr_debug_message 将调试信息发送到输出窗口
lr_error_message 将错误消息发送到输出窗口
lr_get_debug_message 检索当前消息类
lr_log_message 将消息发送到日志文件
lr_output_message 将消息发送到输出窗口
lr_set_debug_message 设置调试消息类
lr_vuser_status_message 生成带格式的输出，并将其写到 ControllerVuser
状态区域
lr_message 将消息发送到 Vuser 日志和输出窗口
lr_load_dll 加载外部 DLL
lr_peek_events 指明可以暂停 Vuser 脚本执行的位置
lr_think_time
暂停脚本的执行，以模拟思考时间（实际用户在操作之间暂停以进行思考的时间）
lr_continue_on_error 指定处理错误的方法

lr_continue_on_error (0）；lr_continue_on_error
（1）；
lr_rendezvous 在 Vuser 脚本中设置集合点
TE_wait_cursor 等待光标出现在终端窗口的指定位置
TE_wait_silent 等待客户端应用程序在指定秒数内处于静默状态
TE_wait_sync 等待系统从 X-SYSTEM 或输入禁止模式返回
TE_wait_text 等待字符串出现在指定位置
TE_wait_sync_transaction 记录系统在最近的 X SYSTEM
模式下保持的时间

WEB函数列表：

web_custom_request 允许您使用 HTTP 支持的任何方法来创建自定义 HTTP
请求
web_image 在定义的图像上模拟鼠标单击
web_link 在定义的文本链接上模拟鼠标单击
web_submit_data 执行“无条件”或“无上下文”的表单
web_submit_form 模拟表单的提交
web_url 加载由“URL”属性指定的 URL
web_set_certificate 使 Vuser 使用在 Internet Explorer
注册表中列出的特定证书
web_set_certificate_ex
指定证书和密钥文件的位置和格式信息
web_set_user 指定 Web 服务器的登录字符串和密码，用于 Web
服务器上已验证用户身份的区域
web_cache_cleanup 清除缓存模拟程序的内容
web_find 在 HTML 页内搜索指定的文本字符串
web_global_verification 在所有后面的 HTTP
请求中搜索文本字符串
web_image_check 验证指定的图像是否存在于 HTML页内
web_reg_find 在后面的 HTTP 请求中注册对
HTML源或原始缓冲区中文本字符串的搜索
web_disable_keep_alive 禁用 Keep-Alive HTTP
连接
web_enable_keep_alive 启用 Keep-Alive HTTP
连接
web_set_connections_limit 设置 Vuser
在运行脚本时可以同时打开连接的最大数目
web_concurrent_end 标记并发组的结束
web_concurrent_start 标记并发组的开始
web_add_cookie 添加新的 Cookie 或修改现有的
Cookie
web_cleanup_cookies 删除当前由 Vuser 存储的所有
Cookie
web_remove_cookie 删除指定的 Cookie
web_create_html_param 将 HTML 页上的动态信息保存到参数中。（LR 6.5
及更低版本）
web_create_html_param_ex 基于包含在 HTML 页内的动态信息创建参数（使用嵌入边界）（LR 6.5
及更低版本）。
web_reg_save_param 基于包含在 HTML
页内的动态信息创建参数（不使用嵌入边界）
web_set_max_html_param_len 设置已检索的动态 HTML
信息的最大长度
web_add_filter 设置在下载时包括或排除 URL 的条件
web_add_auto_filter 设置在下载时包括或排除 URL
的条件
web_remove_auto_filter 禁用对下载内容的筛选
web_add_auto_header 向所有后面的 HTTP
请求中添加自定义标头
web_add_header 向下一个 HTTP 请求中添加自定义标头
web_cleanup_auto_headers 停止向后面的 HTTP
请求中添加自定义标头
web_remove_auto_header 停止向后面的 HTTP
请求中添加特定的标头
web_revert_auto_header 停止向后面的 HTTP
请求中添加特定的标头，但是生成隐性标头
web_save_header 将请求和响应标头保存到变量中
web_set_proxy 指定将所有后面的 HTTP
请求定向到指定的代理服务器
web_set_proxy_bypass 指定 Vuser
直接访问（即不通过指定的代理服务器访问）的服务器列表
web_set_proxy_bypass_local 指定 Vuser 对于本地 (Intranet)
地址是否应该避开代理服务器
web_set_secure_proxy 指定将所有后面的 HTTP
请求定向到服务器
web_set_max_retries 设置操作步骤的最大重试次数
web_set_timeout 指定 Vuser 等待执行指定任务的最长时间
web_convert_param 将 HTML 参数转换成 URL
或纯文本
web_get_int_property 返回有关上一个 HTTP
请求的特定信息
web_report_data_point 指定数据点并将其添加到测试结果中
web_set_option 在非 HTML 资源的编码、重定向和下载区域中设置 Web
选项
web_set_sockets_option 设置套接字的选项

#include "web_api.h"

Action()
{
char*
abort="aborting...";
char *
my_host;
char
*ip;
ip =
lr_get_vuser_ip();
if
(ip)
lr_output_message("The
IP address is %s", ip);

else
lr_output_message("IP
spoofing disabled");

lr_message ("login
failed: %s", abort);

lr_save_datetime("Tomorrow is %B %d %Y", DATE_NOW +ONE_DAY,
"next");

lr_output_message(lr_eval_string("{next}"));
my_host =
lr_get_host_name( );

lr_output_message("您的机器名称：%s", my_host);