UNREFERENCED_PARAMETER作用

本文介绍如何使用UNREFERENCED_PARAMETER宏来避免Visual C++编译器发出的未使用参数警告,并探讨了不同代码风格的选择。

摘要生成于 C知道 ,由 DeepSeek-R1 满血版支持, 前往体验 >

作用:告诉编译器,已经使用了该变量,不必检测警告!

在VC编译器下,如果您用最高级别进行编译,编译器就会很苛刻地指出您的非常细小的警告。当你生命了一个变量,而没有使用时,编译器就会报警告:

“warning C4100: ''XXXX'' : unreferenced formal parameter.” 

所以,为了让编译器不必检测你的警告,就使用UNREFERENCED_PARAMETER语句。比如:

int SomeFunction(int arg1, int arg2)
{
  UNREFERENCED_PARAMETER(arg2)
  ...
}

 

我看到过一些 C++ 代码针对没有使用过的参数用 UNREFERENCED_PARAMETER,例如:

int SomeFunction(int arg1, int arg2)
{
  UNREFERENCED_PARAMETER(arg2)
  ...
}

我还看到过这样的代码:

int SomeFunction(int arg1, int /* arg2 */)
{
  ...
}

你能解释它们的差别吗?哪一种用法更好?

Judy McGeough


 是啊!为什么呢?让我们从 UNREFERENCED_PARAMETER 开始吧。这个宏在 winnt.h 中定义如下:

#define UNREFERENCED_PARAMETER(P) (P)

  换句话说 UNREFERENCED_PARAMETER 展开传递的参数或表达式。其目的是避免编译器关于未引用参数的警告。许多程序员,包括我在内,喜欢用最高级别的警告 Level 4(/W4)进行编译。Level 4 属于“能被安全忽略的事件”的范畴。虽然它们可能使你难堪,但很少破坏你的代码。例如,在你的程序中可能会有这样一些代码行:

int x=1;

  但你从没用到过 x。也许这一行是你以前使用 x 时留下来的,只删除了使用它的代码,而忘了删除这个变量。Warning Level 4 能找到这些小麻烦。所以,为什么不让编译器帮助你完成可能是最高级别的专业化呢?用Level 4 编译是展示你工作态度的一种方式。如果你为公众使用者编写库,Level 4 则是社交礼节上需要的。你不想强迫你的开发人员使用低级选项清洁地编译他们的代码。
  问题是,Level 4 实在是太过于注意细节,在 Level 4 上,编译器连未引用参数这样无伤大雅的事情也要抱怨(当然,除非你真的有意使用这个参数,这时便相安无事)。假设你有一个函数带来两个参数,但你只使用其中一个:

int SomeFunction(int arg1, int arg2)
{
    return arg1+5;
}

使用 /W4,编译器抱怨:

“warning C4100: ''arg2'' : unreferenced formal parameter.”

为了骗过编译器,你可以加上 UNREFERENCED_PARAMETER(arg2)。现在编译器在编译你的引用 arg2 的函数时便会住口。并且由于语句:

arg2;

实际上不做任何事情,编译器不会为之产生任何代码,所以在空间和性能上不会有任何损失。

#define _WINSOCKAPI_ // 防止 Windows Sockets API 被重复定义 #include <windows.h> #include <sal.h> #include <httpserv.h> #include <stdio.h> // 定义主模块类,继承自 IHttpModule class CHelloWorld : public CHttpModule { public: // 请求开始时触发的方法 REQUEST_NOTIFICATION_STATUS OnBeginRequest( IN IHttpContext* pHttpContext, IN IHttpEventProvider* pProvider ) { // 忽略未使用的参数以避免编译警告 UNREFERENCED_PARAMETER(pProvider); // 用于存储方法调用的 HRESULT 返回值 HRESULT hr; // 获取当前 HTTP 请求的响应对象 IHttpResponse* pHttpResponse = pHttpContext->GetResponse(); // 获取当前 HTTP 请求对象 IHttpRequest* pHttpRequest = pHttpContext->GetRequest(); // 分配一块 512 字节的内存用于后续操作 PCSTR pszBuffer = (PCSTR)pHttpContext->AllocateRequestMemory(512); // 获取原始 HTTP 请求结构体指针 HTTP_REQUEST* prawRequest = pHttpRequest->GetRawHttpRequest(); // 提取请求 URL 的原始字符串 PCSTR Url = prawRequest->pRawUrl; // 判断响应对象是否有效 if (pHttpResponse != NULL) { // 清除现有响应内容 pHttpResponse->Clear(); // 设置响应头 Content-Type 为 text/plain pHttpResponse->SetHeader( HttpHeaderContentType, "text/plain", (USHORT)strlen("text/plain"), TRUE ); // 准备要发送给客户端的文本数据 PCSTR pszBuffer = "Hello World!: OnBeginRequest"; // 定义一个 HTTP 数据块结构体 HTTP_DATA_CHUNK dataChunk; // 设置数据块类型为内存块 dataChunk.DataChunkType = HttpDataChunkFromMemory; // 定义变量用于接收实际写入字节数 DWORD cbSent; // 设置数据块的内存地址 dataChunk.FromMemory.pBuffer = (PVOID)pszBuffer; // 设置数据块长度 dataChunk.FromMemory.BufferLength = (USHORT)strlen(pszBuffer); // 将数据块写入 HTTP 响应流中 hr = pHttpResponse->WriteEntityChunks( &dataChunk, 1, FALSE, TRUE, &cbSent, FALSE ); // 判断写入是否成功 if (FAILED(hr)) { // 若失败,则设置 HTTP 状态码为 500 内部服务器错误 pHttpResponse->SetStatus(500, "Server Error", 0, hr); } // 结束请求处理流程 return RQ_NOTIFICATION_FINISH_REQUEST; } // 继续执行其他请求处理逻辑 return RQ_NOTIFICATION_CONTINUE; } }; // 定义模块工厂类,用于创建模块实例 class CHelloWorldFactory : public IHttpModuleFactory { public: // 获取 HTTP 模块实例的方法 HRESULT GetHttpModule( OUT CHttpModule** ppModule, IN IModuleAllocator* pAllocator ) { // 忽略未使用的参数 UNREFERENCED_PARAMETER(pAllocator); // 创建新的模块实例 CHelloWorld* pModule = new CHelloWorld; // 判断是否分配成功 if (!pModule) { // 如果失败则返回内存不足错误 return HRESULT_FROM_WIN32(ERROR_NOT_ENOUGH_MEMORY); } else { // 成功创建后赋值输出参数 *ppModule = pModule; // 将局部指针置空 pModule = NULL; // 返回成功状态 return S_OK; } } // 销毁模块工厂的方法 void Terminate() { // 删除当前对象释放资源 delete this; } }; // 定义全局模块类,用于处理全局事件 class MyGlobalModule : public CGlobalModule { public: // 应用启动时触发的回调函数 GLOBAL_NOTIFICATION_STATUS OnGlobalApplicationStart( _In_ IHttpApplicationStartProvider* pProvider ) { // 忽略未使用的参数 UNREFERENCED_PARAMETER(pProvider); // 当前示例不启用调试输出 // OutputDebugStringA(LPCSTR("Hello World! : OnGlobalApplicationStart")); // 继续执行其他全局通知 return GL_NOTIFICATION_CONTINUE; } // 应用停止时触发的回调函数 GLOBAL_NOTIFICATION_STATUS OnGlobalApplicationStop( _In_ IHttpApplicationStopProvider* pProvider ) { // 忽略未使用的参数 UNREFERENCED_PARAMETER(pProvider); // 当前示例不启用调试输出 // OutputDebugStringA(LPCSTR("Hello World! : OnGlobalApplicationStop")); // 继续执行其他全局通知 return GL_NOTIFICATION_CONTINUE; } // PreBeginRequest 阶段触发的回调函数 GLOBAL_NOTIFICATION_STATUS OnGlobalPreBeginRequest( IN IPreBeginRequestProvider* pProvider ) { // 忽略未使用的参数 UNREFERENCED_PARAMETER(pProvider); // 当前示例不启用调试输出 // OutputDebugStringA(LPCSTR("Hello World! : OnGlobalPreBeginRequest")); // 继续执行其他全局通知 return GL_NOTIFICATION_CONTINUE; } // 析构方法,用于释放资源 VOID Terminate() { // 删除当前对象释放资源 delete this; } // 构造函数,初始化 Event Viewer 句柄 MyGlobalModule() { // 注册事件源到系统日志服务 m_hEventLog = RegisterEventSource(NULL, LPCSTR("IISADMIN")); } // 析构函数,释放 Event Viewer 资源 ~MyGlobalModule() { // 判断句柄是否有效 if (NULL != m_hEventLog) { // 释放句柄并置空 DeregisterEventSource(m_hEventLog); m_hEventLog = NULL; } } private: // 事件日志句柄 HANDLE m_hEventLog; // 写入事件日志的方法 BOOL WriteEventViewerLog(LPCSTR szNotification) { // 判断句柄是否有效 if (NULL != m_hEventLog) { // 报告事件信息到 Event Viewer return ReportEvent( m_hEventLog, EVENTLOG_INFORMATION_TYPE, 0, 0, NULL, 1, 0, &szNotification, NULL ); } // 返回失败状态 return FALSE; } }; // 模块注册入口函数,由 IIS 调用加载模块 HRESULT __stdcall RegisterModule( DWORD dwServerVersion, IHttpModuleRegistrationInfo* pModuleInfo, IHttpServer* pGlobalInfo ) { // 忽略未使用的参数 UNREFERENCED_PARAMETER(dwServerVersion); UNREFERENCED_PARAMETER(pGlobalInfo); // 当前示例不启用调试输出 // OutputDebugStringA(LPCSTR("Hello World! : RegisterModule")); // 创建全局模块实例 MyGlobalModule* pGlobalModule = new MyGlobalModule; // 判断是否创建成功 if (NULL == pGlobalModule) { // 失败则返回内存不足错误 return HRESULT_FROM_WIN32(ERROR_NOT_ENOUGH_MEMORY); } // 注册全局通知,监听 PreBeginRequest 事件 pModuleInfo->SetGlobalNotifications(pGlobalModule, GL_PRE_BEGIN_REQUEST); // 注册请求通知,监听 BeginRequest 事件 return pModuleInfo->SetRequestNotifications( new CHelloWorldFactory, RQ_BEGIN_REQUEST, 0 ); } 我想用IIS模块指定端口访问
07-13
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值