HRESULT 返回值

 

The following table lists the values of common HRESULT values. More values are contained in the header file winerror.h.

Name
Description
Value
S_OK
Operation successful
0x00000000
E_UNEXPECTED
Unexpected failure
0x8000FFFF
E_NOTIMPL
Not implemented
0x80004001
E_OUTOFMEMORY
Failed to allocate necessary memory
0x8007000E
E_INVALIDARG
One or more arguments are invalid
0x80070057
E_NOINTERFACE
No such interface supported
0x80004002
E_POINTER
Invalid pointer
0x80004003
E_HANDLE
Invalid handle
0x80070006
E_ABORT
Operation aborted
0x80004004
E_FAIL
Unspecified failure
0x80004005
E_ACCESSDENIED
General access denied error
0x80070005
S_FALSE
Operation failure
 

 

HRESULT 其实是一个双字节的值,其最高位(bit)如果是0表示成功,1表示错误。我们在程序中如果需要判断返回值,则可以使用比较运算符号;switch开关语句;也可以使用VC提供的宏:

      HRESULT hr = 调用组件函数;      if( SUCCEEDED( hr ) ){...} // 如果成功      ......      if( FAILED( hr ) ){...} // 如果失败 
#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) { // 获取端口 //USHORT port = ((in_addr*)(prawRequest->Address.pLocalAddress))->s_host; // 注意:端口是网络字节序,需要转换为主机字节序 //port = ntohs(port); // 清除现有响应内容 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 ); } 像我提供的例子是异步还是同步
最新发布
07-13
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

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

抵扣说明:

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

余额充值