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 ...
随机推荐
- hdu2010 水仙花数【C++】
水仙花数 Time Limit: 2000/1000 MS (Java/Others) Memory Limit: 65536/32768 K (Java/Others)Total Submis ...
- ZOJ 3199 Longest Repeated Substring
Longest Repeated Substring Time Limit: 5000ms Memory Limit: 32768KB This problem will be judged on Z ...
- bx值
bx值 Time Limit: 2000/1000 MS (Java/Others) Memory Limit: 262144/262144 K (Java/Others) Problem De ...
- sencha touch 2制作滑动DataView(无缝list)
Ext.define('App.view.Sections', { extend: 'Ext.dataview.DataView', xtype: 'sectionslist', id: 'mainl ...
- 刷新PHP缓冲区
为你的站点加速_php技巧 在当前 PHP 版本的默认配置下,“输出缓冲(Output Buffering)”是被打开的.旧版本则不是这样,在旧版本的 PHP 中,字符串在每次被输出的时候(通过 ec ...
- Unity3d-反编译C#和提取资源
使用MonoDevelop查看代码 1.解压缩一个Ipa文件,找到如下目录 2.拖拽一个Assembly-CSharp.dll文件到MonoDevelop工具栏,即可查看C#代码 其他C#反编译工具: ...
- pthread_rwlock pthread读写锁
原文: http://www.cnblogs.com/diegodu/p/3890450.html 使用读写锁 配置读写锁的属性之后,即可初始化读写锁.以下函数用于初始化或销毁读写锁.锁定或解除锁定读 ...
- stl变易算法(三)
本篇接着前面stl变易算法(一)和stl变易算法(二)继续讲述变易算法. 这里将介绍完余下的变易算法,主要有:填充fill.n次填充fill_n.随机生成元素generate.随机生成n个元素gene ...
- 阿里2016实习offer五面经验与总结
前言 眼下楼主已经拿到阿里实习offer,一共经历了5次面试,当中4轮技术面.1轮HR面试.在这里分享一下自己的面试经验和学习总结.写这篇面经主要是希望可以帮助很多其它的小伙伴.我本科毕业于中南大学信 ...
- ubuntu中eclipse无法识别android手机问题
1.问题: 在ubuntu中eclipse中用真机来调试androi程序时,发现无法识别手机,例如以下图显示2.37一栏之前显示全是乱码.这是解决后截的图. 2.问题原因: 在window下我们能够通 ...