C#面对“重载”的Win 32 函数
在Win32 Api中有很多添加/设置函数在参数上支持多种不同类型的结构体。这些参数定义为LPVOID* 或者LPBYTE,LPVOID*一般由Win32 分配内存空间,在C#从通过System.IntPtr进行遍历[1]。LPBYTE空间在函数调用的外部进行分配,之所以定义为LPBYTE,是因为这些结构体可能并不相同——属性、大小不同。那么在C#中如何处理这种LPBYTE接收多种结构体引用的Win32 Api?
先看一个Win 32 API的定义:
//The NetUserSetInfo function sets the parameters of a user account. //Syntax [2] NET_API_STATUS NetUserSetInfo(
_In_ LPCWSTR servername,
_In_ LPCWSTR username,
_In_ DWORD level,
_In_ LPBYTE buf,
_Out_ LPDWORD parm_err
); //LPBYTE支持的结构体有二十多种
/**buf部分类型说明
0
Specifies the user account name. The buf parameter points to a USER_INFO_0 structure. Use this structure to specify a new group name. For more information, see the following Remarks section. 1
Specifies detailed information about the user account. The buf parameter points to a USER_INFO_1 structure.
....
1005
Specifies a user privilege level. The buf parameter points to a USER_INFO_1005 structure.
.....
**/
LPBYTE buf支持的类型多达二十多个,面对这种情况,一般可以有两种解决办法。LPBYTE是一个字节数组(栈或者堆)指针,在C#中对应的类型为System.UInt[]。但在此函数中,LPBYTE buf是指向结构体首地址的地址指针。所以第一种方法是直接传入IntPtr。IntPtr是一个神奇的类型,MSDN是这样介绍的[3]:
A platform-specific type that is used to represent a pointer or a handle.
用于表示指针或句柄的平台特定类型。 在Remark是这样说的: The IntPtr type can be used by languages that support pointers, and as a common means of referring to data between languages that do and do not support pointers. MSDN机器翻译: IntPtr 语言中所支持的指针,并作为一种常见的方式来指代语言,并不支持指针之间的数据,则可以使用类型。
MSDN机器翻译我个人认为是错误的,我个人翻译为:
IntPtr可以被支持指针,或者那些不支持指针,而使用通常意义上的数据的引用做指针所做的事的各种(编程)语言使用。(.NET支持多种语言,有些语言支持指针。)
基于以上,第一种方法这是使用System.IntPtr来类型替换LPBYTE,支持多种变化的结构体Buf。那么该函数在C#中的定义即为:
[DllImport("Netapi32.dll", CharSet = CharSet.Unicode)]
internal static extern uint NetUserSetInfo(
[MarshalAs(UnmanagedType.LPWStr)] string servername,
[MarshalAs(UnmanagedType.LPWStr)] string username,
uint level,
IntPtr buf,
uint parm_err);
第二种方法基于Win32 Api函数的“重载”——类似于通过参数实现的重载。如果在使用某一个函数时,不考虑其通用性而考虑具体性,可以直接将函数定义为具体的结构体类型。比如如下定义:
[DllImport("Netapi32.dll", CharSet = CharSet.Unicode)]
internal static extern uint NetUserSetInfo(
[MarshalAs(UnmanagedType.LPWStr)] string servername,
[MarshalAs(UnmanagedType.LPWStr)] string username,
uint level,
ref USER_INFO_1003 buf,
uint parm_err); [DllImport("Netapi32.dll", CharSet = CharSet.Unicode)]
internal static extern uint NetUserSetInfo(
[MarshalAs(UnmanagedType.LPWStr)] string servername,
[MarshalAs(UnmanagedType.LPWStr)] string username,
uint level,
ref USER_INFO_1017 buf,
uint parm_err);
这两个函数在C#中属于重载函数,支持USER_INFO_1003 和 USER_INFO_1017两个类型。当需要较多的重载函数时,这种方法稍显冗余,使用IntPtr更加有弹性。
毕竟,Win32 只是想得到结构体的地址指针。使用具体类型的引用(ref)或者IntPtr都可以做到。
参考:
[1] 遍历LPVOID*, http://www.cnblogs.com/jjseen/p/win32_api.html
[2] NetSetUserInfo, https://msdn.microsoft.com/zh-cn/data/aa370659(v=vs.100)
[3] IntPtr结构, https://msdn.microsoft.com/zh-cn/library/system.intptr(v=vs.110).aspx
C#面对“重载”的Win 32 函数的更多相关文章
- (转)C#调用非托管Win 32 DLL
转载学习收藏,原文地址http://www.cnblogs.com/mywebname/articles/2291876.html 背景 在项目过程中,有时候你需要调用非C#编写的DLL文件,尤其在使 ...
- C#访问Win 32的一些尝试
使用C#调用Win 32 Api大部分情况下基本只涉及到参数类型的转变,但在遇到Win 32 Api返回LPVOID *lpBuff 时会遇到一些解析遍历难题.lpBuff为二维指针,*lpBuff是 ...
- 【Windows编程】入门篇——win 32窗口的hello word!
✍ Windows编程基础 1.Win 32应用程序基本类型 1) 控制台程序 不需要完善的windows窗口,可以使用DOS窗口方式显示 2) Win 32窗口程序 包含窗口的程序,可以通过窗 ...
- VCL控件组件大都应该重载TWinControl的虚函数WndProc来进行处理窗口消息的工作
TWinControl的构造函数中会调用MakeObjectInstance并且传递MainWndProc作为窗口消息处理函数,而MainWndProc则会调用虚函数WndProc来处理窗口消息.留个 ...
- 重载operator new delete函数
可以重载global的operator new delete 函数,细节如下: MyNewDelete.h #pragma once #include <stdlib.h> #includ ...
- [原创] Delphi Win API函数 操作帮助文件 HtmlHelpA函数介绍
Delphi Win API函数 操作帮助文件 HtmlHelpA函数介绍 函数原型:HWND HtmlHelpA( HWND hwndCaller, LPCSTR pszFile, UINT uCo ...
- Delphi Win API 函数 MulDiv
Delphi Win API 函数 MulDiv 原型:function MulDiv(nNumber, nNumerator, nDenominator: Integer): Integer; st ...
- 虚函数的使用 以及虚函数与重载的关系, 空虚函数的作用,纯虚函数->抽象类,基类虚析构函数使释放对象更彻底
为了访问公有派生类的特定成员,可以通过讲基类指针显示转换为派生类指针. 也可以将基类的非静态成员函数定义为虚函数(在函数前加上virtual) #include<iostream> usi ...
- Delphi Win API 函数 [ ShellAPI ] ShellExecute 函数
引用单元:uses ShellAPI; 函数原型:function ShellExecute(hWnd: HWND; Operation, FileName, Parameters,Directory ...
随机推荐
- vue 根据网站路由判断页面主题色
需求: 不同品牌对应不同版本配色 做法: 根据域名带的参数判断进入哪个品牌,对应哪个版本 在main.js中 import Vue from 'vue' import App from './App' ...
- bx值
bx值 Time Limit: 2000/1000 MS (Java/Others) Memory Limit: 262144/262144 K (Java/Others) Problem De ...
- (39.4) Spring Boot Shiro权限管理【从零开始学Spring Boot】
在读此文章之前您还可能需要先了解: (39.1) Spring Boot Shiro权限管理[从零开始学Spring Boot] http://412887952-qq-com.iteye.com/b ...
- 如何快速恢复SLAVE从库上某几张表
在日常工作中,同步报错是DBA遇到最多的一个问题,如果修复后发现还没有解决,通常的办法是在master上重新导入一份备份,然后在slave上恢复,这个方案是针对整个库不是很大的情况,那么如果是数据库比 ...
- Spark Streaming接收Kafka数据存储到Hbase
Spark Streaming接收Kafka数据存储到Hbase fly spark hbase kafka 主要参考了这篇文章https://yq.aliyun.com/articles/60712 ...
- springmvc 时间返回格式化
如果是@ResponseBody,可以通过@JsonFormat(pattern="yyyy-MM-dd HH:mm:ss")设置返回的样式: 如果是不是@ResponseBody ...
- web端log4net输出错误日志到mysql
1.引用log4net 2.配置log4net.config文件 <?xml version="1.0" encoding="utf-8" ?> & ...
- Advapi32.dll 函数接口说明
Advapi32.dll 函数接口说明 函数原型 说明 AbortSystemShutDown ...
- python 函数参数的传递(参数带星号的说明)
python中函数参数的传递是通过赋值来传递的.函数参数的使用又有俩个方面值得注意:1.函数参数是如何定义的 2.在调用函数的过程中参数是如何被解析 先看第一个问题,在python中函数参数的定义主要 ...
- Android多级目录树
本例中目录树的菜单数据是从json数据中获取,首先建立一个菜单实体类 MenuTree package com.gao.tree; /** * 菜单树的各级菜单实体类 * * @author tjs ...