aview-app 1.0.2

package/aardio/lib/sys/mpPreference.aardio

@@ -0,0 +1,159 @@
+//mpPreference 安全设置
+import dotNet.ps;
+import fsys.path;
+import win.reg;
+
+namespace sys.mpPreference;
+
+set = function(p){ 
+	return ..dotNet.ps.command("Set-MpPreference",p) 
+}
+
+get = function(p){ 
+	return ..dotNet.ps.json(`Get-MpPreference | ConvertTo-Json `)	
+}
+
+remove = function(p){ 
+	return ..dotNet.ps(`Remove-MpPreference`,p)	
+}
+
+add = function(p){ 
+	return ..dotNet.ps(`Add-MpPreference`,p)	
+}
+
+getThreatDetection = function(){
+	return ..dotNet.ps.json(`Get-MpThreatDetection | ConvertTo-Json `)	
+}
+
+getThreat = function(){
+	return ..dotNet.ps.json(`Get-MpThreat | ConvertTo-Json `)	
+}
+
+getExclusionPaths = function(paths){
+    if(!_WIN10_LATER) return;
+	var ret,err = ..dotNet.ps("Get-MpPreference  | Select-Object -ExpandProperty ExclusionPath");
+	//HKLM\SOFTWARE\Microsoft\Windows Defender\Exclusions
+	
+	if(ret!==null) {
+		var exclusionPaths = ..string.splitEx(..string.trim(ret));
+		if(!exclusionPaths){
+			return null,err;
+		}
+			
+		if(#exclusionPaths==1 && !..io.exist(exclusionPaths[1])){
+			return null,exclusionPaths[1]
+		}
+		
+		for(k,path in paths){
+			path = ..fsys.path.removeBackslash(path);  
+			
+			if(!..table.find(exclusionPaths,lambda(v,k) ..fsys.path.cmp(v,path)===0 || ..fsys.path.ischild(v,path) ) ){
+				..table.push(exclusionPaths,path); 
+			} 
+		}
+		
+		return exclusionPaths;	
+	}
+}
+
+isExclusionPath = function(path){
+	path = ..fsys.path.removeBackslash(path);
+	
+	var exclusionPaths = getExclusionPaths() : {};
+	if(!..table.find(exclusionPaths,path) ){
+		..table.push(exclusionPaths,path); 
+	}
+	
+	for(k,e in exclusionPaths){
+		if(..fsys.path.cmp(e,path)){
+			return true;
+		}
+		
+		if(..fsys.path.ischild(e,path) ){
+			return true;
+		}
+	}
+}
+
+addExclusionPath = function(path){
+    if(!_WIN10_LATER) return;
+    
+    import ..dotNet.ps;
+	path = ..fsys.path.removeBackslash(path); 
+	
+	var exclusionPaths = getExclusionPaths() : {};
+	if(!..table.find(exclusionPaths,path) ){
+		..table.push(exclusionPaths,path); 
+	}
+	
+	return ..dotNet.ps.command("Set-MpPreference",{ExclusionPath=#exclusionPaths?exclusionPaths:""})
+}
+
+setExclusionPaths = function(exclusionPaths){
+    if(!_WIN10_LATER) return;
+    
+    for(k,v in exclusionPaths){
+    	exclusionPaths[k] = ..fsys.path.removeBackslash(v); 
+    }
+    
+    exclusionPaths = ..table.unique(exclusionPaths);
+	return ..dotNet.ps.command("Set-MpPreference",{ExclusionPath=#exclusionPaths?exclusionPaths:""})
+}
+
+isTamperProtection = function(){
+	return 4 != ..win.reg.queryWow64("HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows Defender\Features","TamperProtection");
+}
+
+isRealtimeMonitoring = function(){
+	return 1 != ..win.reg.queryWow64("HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows Defender\Real-Time Protection","DisableRealtimeMonitoring");
+}
+
+disableRealtimeMonitoring = function(disabled){
+	if(isTamperProtection()) return false;
+	
+	..dotNet.ps.command("Set-MpPreference",{DisableRealtimeMonitoring=!!disabled})
+	return !isRealtimeMonitoring();
+}
+
+/**intellisense()
+sys.mpPreference = Windows Defender 设置，\n注意修改 Defender 设置需要管理权限。\n请参考相关扩展库 process.mpCmdRun
+end intellisense**/
+
+/**intellisense(sys.mpPreference)
+get(__) = 调用 Get-MpPreferenc 获取 Windows Defender 设置，\n返回包含配置项名值对的表
+set(__) = 调用 Set-MpPreferenc 修改 Windows Defender 设置，\n参数 @1 指定包含配置项名值对的表，配置项名称前不必加短横线。\n可用配置项参考 https://docs.microsoft.com/en-us/powershell/module/defender/set-mppreference
+remove(__) = 调用 Remove-MpPreference 移除 Windows Defender 设置，\n参数 @1 指定包含配置项名值对的表，配置项名称前不必加短横线。\n可用配置项参考 https://docs.microsoft.com/en-us/powershell/module/defender/remove-mppreference
+add(__) = 调用 Add-MpPreference 修改 Windows Defender 设置，\n参数 @1 指定包含配置项名值对的表，配置项名称前不必加短横线。\n可用配置项参考 https://docs.microsoft.com/en-us/powershell/module/defender/add-mppreference
+getExclusionPaths() = 获取例外目录列表，返回路径数组,\n可选在参数中指定要添加到返回列表中的路径,\n如果参数中传入的目录或该目录的父目录已经在排除列表中，则自动排除
+addExclusionPath(__) = 添加一个路径到例外目录列表
+setExclusionPaths(__) = 修改例外目录列表，参数传入路径数组,\n此函数自动除重
+isExclusionPath(__) = 参数指定的路径是否属于例外目录
+disableRealtimeMonitoring(true) = 关闭实时保护。\n需要用 thread.trustedInstaller 扩展库获取权限。\n需要事先关闭 Tamper Protection，\n可用 sys.mpPreference.isTamperProtection 函数检测该设置。\nTamper Protection 只能手动关闭，\n可调用 raw.execute("windowsdefender://ThreatSettings") 打开设置页
+isTamperProtection() = 是否关闭 Tamper Protection\nTamper Protection 只能手动关闭，\n可调用 raw.execute("windowsdefender://ThreatSettings") 打开设置页
+isRealtimeMonitoring() = 当前是否开启实时保护
+getThreat() = 返回检测到的威胁的历史记录
+getThreatDetection() = 返回所有检测到的威胁明细
+end intellisense**/
+
+/**details(打开 Defender 设置)
+raw.execute("windowsdefender://Threat");               # Virus & Threat Protection
+raw.execute("windowsdefender://ThreatSettings");       # Virus & Threat Protection Settings
+raw.execute("windowsdefender://Account");              # Account Protection
+raw.execute("windowsdefender://Network");              # Firewall & network Protection
+raw.execute("windowsdefender://Hardware");             # Device Security
+raw.execute("windowsdefender://DeviceSecurity");       # Device Security
+raw.execute("windowsdefender://Family");               # Family Option
+raw.execute("windowsdefender://AppBrowser");           # App & Browser Control
+raw.execute("windowsdefender://Settings");             # Manage Notifications
+raw.execute("windowsdefender://History");              # Protection History
+raw.execute("windowsdefender://RansomwareProtection"); # Ransomware Protection
+raw.execute("windowsdefender://ProtectedFolders");     # Ransomware Protection
+raw.execute("windowsdefender://SecurityProcessor");    # Security Processor Details
+raw.execute("windowsdefender://SecurityProcessorTroubleshooting"); #  Security Processor Troubleshooting
+raw.execute("windowsdefender://SmartScreenPua");       # Smart Screen (Reputation Based Protection)
+raw.execute("windowsdefender://AccountProtection");    # Account Protection
+raw.execute("windowsdefender://ExploitProtection");    # Exploit Protection
+raw.execute("windowsdefender://exclusions");           # exclusions
+raw.execute("windowsdefender://fullscan");             # Select fullscan
+raw.execute("windowsdefender://quickscan");            # Start quickscan 
+end details**/

package/aardio/lib/sys/networkCards.aardio

@@ -0,0 +1,84 @@
+//networkCards 网卡设备
+import sys.device;
+import win.reg;
+
+namespace sys.networkCards;
+		
+each = function(...){
+	
+	var enumerators = ...;
+	if( type.isString(enumerators) ) enumerators = { ... };  
+	
+	var id2desc = {};
+	var hardwareIds = {};
+	
+	if(enumerators){
+		for(k,enumerator in enumerators){
+			var devices = ..sys.device("{4d36e972-e325-11ce-bfc1-08002be10318}"/*_GUID_DEVCLASS_NET*/,enumerator);
+			for( index,ids,desc in devices.each( 1/*_SPDRP_HARDWAREID*/,0/*_SPDRP_DEVICEDESC*/ ) ) {
+				..table.append(hardwareIds,ids);  
+				for(k,id in ids) id2desc[id] = desc;
+				
+			}
+			devices.destroy();
+		}	
+	}
+	else {
+		var devices = ..sys.device("{4d36e972-e325-11ce-bfc1-08002be10318}"/*_GUID_DEVCLASS_NET*/,enumerator);
+		for( index,ids,desc in devices.each( 1/*_SPDRP_HARDWAREID*/,0/*_SPDRP_DEVICEDESC*/ ) ) {
+			..table.append(hardwareIds,ids);  
+			for(k,id in ids) id2desc[id] = desc;
+			
+		}
+		devices.destroy();
+	} 
+	
+	var result = {}
+	var reg  = ..win.regReader("HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Network\{4D36E972-E325-11CE-BFC1-08002BE10318}");
+	if(!reg) return result;
+	
+	for(adapterName in reg.eachKey() ){
+		var regAdapter = reg.open(adapterName + "\Connection"); 
+		if(regAdapter){
+			var pnpInstanceId = regAdapter.queryValue("PnPInstanceId");
+			var netConnectionId = regAdapter.queryValue("Name");
+			if(pnpInstanceId && netConnectionId){
+				for(i=1;#hardwareIds;1){
+					if(..string.startWith(pnpInstanceId,hardwareIds[i],true)){
+						..table.push(result,{
+							netConnectionId = netConnectionId;
+							pnpInstanceId = pnpInstanceId;
+							hardwareId = hardwareIds[i];
+							description = id2desc[hardwareIds[i]];
+							adapterName = adapterName;
+						});
+						break;
+					} 
+				}
+				
+			}
+			
+			regAdapter.close()
+		}
+	}
+	
+	var idx = 0;
+	return function(){
+		idx++;
+		return result[idx];
+	}; 
+}
+
+/**intellisense()
+sys.networkCards = 用于获取网卡硬件信息（含禁用网卡）。\n而 inet.adapter，inet.adapterInfo 可获取网络适配器配置信息。\n\n可使用 com.wmi 查询 Win32_NetworkAdapter 得到网卡信息,\n com.wmi 查询 Win32_NetworkAdapterConfiguration 得到网络适配器连接配置
+sys.networkCards.each(enumerators->->->) = @for networkCard in sys.networkCards.each(){\n	__/*networkCard 是包含网卡信息的表对象\n@enumerators 参数可用一个字符串数组，或任意个字符串参数指定枚举类型，\n例如 "PCI","USB", 一般不必指定*/\n}
+sys.networkCards.each() = !stdSysNetworkCard.
+end intellisense**/
+
+/**intellisense(!stdSysNetworkCard)
+netConnectionId = 网络连接名称
+pnpInstanceId = 设备实例 ID, 由"设备 ID\实例 ID"组成\n用于 process.devcon 的参数时前面要加 "@" 字符
+hardwareId = 设备 ID
+description = 硬件描述
+adapterName = 适配器 GUID
+end intellisense**/

package/aardio/lib/sys/networkIsolation.aardio

@@ -0,0 +1,160 @@
+//networkIsolation 网络隔离
+import sys.acl;
+import process;
+
+namespace sys.networkIsolation;
+	
+try{
+::FirewallApi = ..raw.loadDll("Firewallapi.dll");
+}
+
+class INET_FIREWALL_APP_CONTAINER {
+	ptr appContainerSid;
+	ptr userSid;
+	ustring appContainerName;
+	ustring displayName;
+	ustring description;
+	struct capabilities = {
+		INT count;
+		ptr capabilities;
+	};
+	struct binaries = {
+		INT count;
+		ptr binaries;
+	};
+	ustring workingDirectory;
+	ustring packageFullName;
+}  
+
+var sidToString = ..sys.acl.sidToString;
+
+getAppContainers = function(){
+    var enumAppContainers = ::FirewallApi.NetworkIsolationEnumAppContainers;
+    if(!enumAppContainers){
+    	return {};
+    }
+    
+	var numPublicAppCs = {INT count}
+	var publicAppCs = {ptr ptr}
+	if( 0 == enumAppContainers(2/*NETISO_FLAG_MAX*/,numPublicAppCs,publicAppCs) ){
+		var apps = ..raw.convertArray(publicAppCs.ptr,numPublicAppCs.count,INET_FIREWALL_APP_CONTAINER)
+		for(i=1;#apps;1){
+			apps[i].sid = sidToString(apps[i].appContainerSid)
+		} 
+		
+		::FirewallApi.NetworkIsolationFreeAppContainers(publicAppCs.ptr);
+		
+		var exemptApps = getLoopbackState();
+		for(i,cfg in configs){ exemptApps[cfg.sid] = true; } 
+		 
+		for(k,app in apps){
+			app.loopback = exemptApps[app.sid];
+		}
+	
+		return apps;
+	}
+}
+ 
+getAppContainerByName = function(name) {
+	var i,v = ..table.find(getAppContainers(),lambda(ct) ..string.cmp(ct.appContainerName,name)==0 );
+	return v;
+} 
+
+getAppContainerConfig = function(){
+	var numPublicAppCs = {INT count}
+	var publicAppSids = {ptr ptr}
+	if( 0 == ::FirewallApi.NetworkIsolationGetAppContainerConfig(numPublicAppCs,publicAppSids) ){
+		var configs = ..raw.convertArray(publicAppSids.ptr,numPublicAppCs.count,{ ptr sid;INT attributes;})
+		if(!configs) return {};
+		
+		var heap = ::Kernel32.GetProcessHeapP();
+	 	for(i=1;#configs;1){
+	 		var sid = configs[i].sid;
+			configs[i].sid = sidToString(sid)
+			::Kernel32.HeapFree(heap, 0, sid);
+		}  
+    
+    	::Kernel32.HeapFree(heap, 0, publicAppSids.ptr);
+		return configs;
+	}
+	
+	return {};
+} 
+
+getLoopbackState = function(){
+	var configs = getAppContainerConfig();
+	
+	var result = {};
+	for(i,cfg in configs){
+		result[cfg.sid] = true;
+	} 
+	
+	return result;
+}
+
+var sidFromString = ..sys.acl.sidFromString;
+enableLoopback = function(sids){
+	var configs = getAppContainerConfig();
+	for(i=#configs;1;-1){
+		if(sids[configs[i].sid]!==null){
+			..table.remove(configs,i);
+		} 
+	}
+	
+	for(sid,enabled in sids){
+		if(enabled){
+			..table.push(configs,{
+				ptr sid = sid;
+				INT attributes;
+			});
+		}
+	}
+	
+	for(i=#configs;1;-1){
+		configs[i].sid = sidFromString(configs[i].sid);
+	}
+	
+	var e = ::FirewallApi.NetworkIsolationSetAppContainerConfig(#configs,#configs?{ struct configs[] = configs }:null);
+	if(e){ return false,..lasterr(e); }
+	return true;
+}
+
+exempt = function(name,disabled){
+    var cts = getAppContainers();
+    for(k,ct in cts){
+    	if((..string.cmp(ct.appContainerName,name)==0) || (ct.sid==name)){
+    		if(ct.loopback==!disabled){
+    			return true;
+    		}
+    		
+    		return enableLoopback({[ct.sid]=!disabled})
+    	} 
+    } 	
+}
+
+exemptAs = function(name,disabled){
+    var cts = getAppContainers();
+    for(k,ct in cts){
+    	if((..string.cmp(ct.appContainerName,name)==0) || (ct.sid==name)){
+    		if(ct.loopback==!disabled){
+    			return true;
+    		}
+    		
+    		return !!..process.executeWait("CheckNetIsolation.exe", `LoopbackExempt ` +(disabled?"-d":"-a")+` -p="`+ct.sid+`"`,"runas",0/*_SW_HIDE*/)
+    	} 
+    } 	
+}
+
+/**intellisense(sys.networkIsolation)
+getAppContainers() = 返回包含所有APP容器信息的数组
+getAppContainerByName(.(name) = 使用容器名查找并返回容器信息 
+getAppContainerConfig() = 获取所有APP容器的本机网络配置,\n返回值是一个数组，数组无素请查看此函数源码
+getLoopbackState() = 获取所有APP容器的本机网络配置,\n返回值是一个表，键为SID字符串，值指定是否允许访问本机网络
+enableLoopback(sidConfigs) = 允许或禁用指定APP容器是否可以访问本机网络\n参数必须是一个表，键为SID字符串，值指定是否允许访问本机网络,\n仅修改指定SID的配置,\n成功返回true,失败返回false,错误信息
+exempt(.(nameOrSid,disabled) = 允许或禁用指定APP容器是否可以访问本机网络\n@nameOrSid参数指定应用容器名或SID,\n可选参数@disabled指定是否禁用访问本机网络,\n成功返回true,失败返回false,错误信息,\n如果无需修改直接返回true,\n否则进程不是以管理权限启动时会失败并返回false
+exemptAs(.(nameOrSid,disabled) = 以管理权限允许或禁用指定APP容器是否可以访问本机网络\n@nameOrSid参数指定应用容器名或SID,\n可选参数@disabled指定是否禁用访问本机网络,\n成功返回true,失败返回false,错误信息,\n如果无需修改直接返回true,
+end intellisense**/
+
+/**intellisense()
+sys.networkIsolation = 用于管理 UWP 应用网络隔离配置,仅适用于 WIN10。
+end intellisense**/

package/aardio/lib/sys/power/_.aardio

@@ -0,0 +1,180 @@
+//power 电源管理
+import process.popen;
+
+namespace sys.power;
+
+status = function(){
+	var status = {
+  		BYTE acLineStatus;
+  		BYTE batteryFlag;
+  		BYTE batteryLifePercent;
+  		BYTE systemStatusFlag;
+  		INT batteryLifeTime;
+  		INT batteryFullLifeTime;
+	} 
+	
+	if( ::Kernel32.GetSystemPowerStatus(status)	) return status;
+}
+
+isAcOnline = lambda() status()[["acLineStatus"]] == 1;
+
+command = function(...){
+	var prcs = ..process.popen.wow64("powercfg",...);
+	if(prcs) return prcs.readAll(,,0);
+}
+
+list = function(){
+	var prcs = ..process.popen.wow64("powercfg","-list");
+	if(!prcs) return;
+	
+	var str = prcs.readAll(); 
+	
+	var result = {};
+	for(line in ..string.lines(str)){
+		
+   		var guid,name,active = ..string.match(line,"(\x{8}-\x{4}-\x{4}-\x{4}-\x{12})\s*\((.+)\)\s*(\*?)");
+   		if(!guid) continue;
+   		
+ 		..table.push(result,{
+ 			guid = guid;
+ 			name = name;
+ 			active  = !!#active;
+ 		})
+ 		
+ 		if(#active){
+ 			result.current = guid;
+ 		}
+	}
+	
+	return result;	
+}
+
+aliases = function(){
+	if(__aliases) return __aliases;
+	
+	var prcs = ..process.popen.wow64("powercfg","-aliases");
+	if(!prcs) return;
+	
+	var str = prcs.readAll(); 
+	
+	var result = {};
+	for(line in ..string.lines(str)){
+		
+   		var guid,name = ..string.match(line,"(\x{8}-\x{4}-\x{4}-\x{4}-\x{12})\s*(\S+)");
+ 		if(name)result[name] = guid; 
+	}
+	
+	__aliases = result;
+	return result;	
+}
+
+currentScheme = function(){
+	return list()[["current"]];
+}
+
+query = function(sub,prop,scheme){
+	if(!scheme) scheme = currentScheme();
+	if(!sub) error("请指定参数@1",2)
+	
+	sub  = aliases()[[sub]] : sub;  
+	if(prop) prop  = aliases()[[prop]] : prop;  
+
+	var prcs = ..process.popen.wow64("powercfg","-query",scheme,sub);
+	if(prcs) {
+		var str = prcs.readAll(,,0);
+		if(str){ 
+			var tab = ..string.split(str,'<\r\n\r\n>');
+			var result  = {};
+			for(k,v in tab){
+				var guid,desc,strValue = ..string.match(v,".+\s+GUID\:\s+(\x{8}-\x{4}-\x{4}-\x{4}-\x{12})\s*\((.+)\)\s*(.+)" )
+				if(guid && strValue){
+					var value = {desc=desc}
+					for(line in ..string.lines(strValue) ){
+						var k,v = ..string.match(line,"\s*([^\:]+?)\:\s+(\S+)");
+						..table.push(value,{v,k});
+					}
+					
+					if(prop &&(prop==guid)){
+						return value;
+					}
+					
+					result[guid] = value;
+				} 
+			}
+			
+			return result;
+		}
+	}
+}
+
+change = function(setting,value){
+	if(!setting) error("请指定参数@1",2)
+	if(value===null) error("请指定参数@2",2)
+	
+	if(!..string.find(setting,"\-[ad]c$")){
+		setting = setting ++ (isAcOnline()?"-ac":"-dc");
+	}
+	
+	command("-change",setting,value);
+}
+
+setValueIndex = function(sub,prop,value,scheme){
+	if(!scheme) scheme = "SCHEME_CURRENT";
+	if(!sub) error("请指定参数@1",2)
+	if(!prop) error("请指定参数@2",2)
+	if(value===null) error("请指定参数@3",2)
+	
+	if(isAcOnline()){
+		command("-setacvalueindex",scheme,sub,prop,tostring(value));
+		command("-setactive",scheme);	
+	}
+	else {
+		command("-setdcvalueindex",scheme,sub,prop,tostring(value));
+		command("-setactive",scheme);	
+	}
+}
+
+setMonitorTimeout = function(v){
+	setValueIndex("SUB_VIDEO","VIDEOIDLE",v);
+}
+
+getMonitorTimeout = function(){
+	var setting = query("SUB_VIDEO","VIDEOIDLE");
+	if(#setting){
+		var v  = setting[#setting-(isAcOnline()?1:0)][[1]]
+		if(v){
+			return (tonumber(v));
+		}
+	}
+}
+
+settings = function(){
+	if(_WIN10_LATER){
+		..process.execute("ms-settings:powersleep");
+	}
+	else {
+		..process.execute("control.exe","/name Microsoft.PowerOptions /page pageGlobalSettings");
+	}
+}
+
+/**intellisense(sys.power)
+status() = 返回表示电源状态的 SYSTEM_POWER_STATUS 结构体\n结构体文档:\nhttps://docs.microsoft.com/en-us/windows/win32/api/winbase/ns-winbase-system_power_status
+isAcOnline() = 当前使用外部电源返回 true\n使用电池返回 false
+command() = 调用 powercfg 命令，返回进程输出
+list() = 返回包含所有电源方案的数组，\n数组格式请参考此函数源码，或打印输出查看。\n返回对象的 current 属性为当前使用的电源方案 GUID
+aliases() = 返回一个表，键为别名，值为对应的 GUID，\n不应修改返回表内容
+currentScheme() = 当前电源方案 GUID
+query( = 查询电源方案
+query(.(sub,setting,scheme) = 查询电源方案\n@sub 指定子组 GUID，\n@prop 指定设置别名或设置 GUID，省略返回所有设置，\n@scheme 指定电源方案，省略则为当前电源方案
+change(.(sub,setting,scheme)  = 查询电源方案\n参考 https://docs.microsoft.com/en-us/windows-hardware/design/device-experiences/powercfg-command-line-options#option_change
+change(.(setting,value) = 改变指定的设置值，\n@参数@1指定设置名，可省略 ac,dc 后缀，\n参数@指定设置值
+setValueIndex( = 修改方案设置值
+setValueIndex(.(sub,prop,value,scheme) = 参数@sub 指定子组 GUID，\n@prop 指定设置别名或设置 GUID，不可省略，\n@value 指定新的值，不可省略。\n@scheme 指定电源方案，省略则为当前电源方案
+setMonitorTimeout(__) = 设置显示器空闲关闭的超时值，\n参数@1 指定超时，以秒为单位，设为 0 则禁用空闲关屏
+getMonitorTimeout() = 返回显示器空闲关闭的超时值，以秒为单位
+settings() = 打开电源管理
+end intellisense**/
+
+/**intellisense()
+sys.power = 电源管理，支持除 XP 以外的所有操作系统
+end intellisense**/

package/aardio/lib/sys/power/notification.aardio

@@ -0,0 +1,91 @@
+//notification 事件通知
+import win.guid;
+namespace sys.power;
+
+class notification{
+	ctor(winform,guid,dataStruct){
+		if( type.isString(guid) ) guid = ..win.guid(guid);
+		if( !dataStruct ) dataStruct = {INT value};
+		
+		if(guid){
+			this.handle = ::User32.RegisterPowerSettingNotificationP(winform.hwnd,guid,0);	
+		}
+		
+		var powerSetting = {struct setting = ..win.guid(); INT len};
+		var sizePowerSetting = ..raw.sizeof(powerSetting);
+		
+		winform.wndproc = {
+			[0x218/*_WM_POWERBROADCAST*/] = function(hwnd,message,wParam,lParam){ 
+				if(wParam == 0x8013){
+					if(this.onPowerSettingChange){
+						var ptr = topointer(lParam);
+						var set = ..raw.convert(ptr,powerSetting);
+						
+						if(dataStruct){
+							var st = ..table.assign({},dataStruct);
+							if(st && ..raw.sizeof(st)==set.len) {
+								..raw.convert(ptr,st,sizePowerSetting);
+								this.onPowerSettingChange(tostring(set.setting),st[["value"]] === null ?  st : st[["value"]]);
+								return;
+							}
+						}
+						 
+						var data = ..raw.buffer(set.len,topointer( lParam,sizePowerSetting));
+						this.onPowerSettingChange(tostring(set.setting),data);
+					}
+				}
+				elseif(wParam == 0xA){
+					if(this.onPowerStatusChange){
+						var status = {
+  							BYTE acLineStatus;
+  							BYTE batteryFlag;
+  							BYTE batteryLifePercent;
+  							BYTE systemStatusFlag;
+  							INT batteryLifeTime;
+  							INT batteryFullLifeTime;
+						} 
+						
+						if( ::Kernel32.GetSystemPowerStatus(status)	) {
+							this.onPowerStatusChange(status)
+						} 
+					}
+				}
+				elseif(wParam == 0x7){
+					if(this.onResuming ){
+						this.onPowerResuming(false) //手动
+					}
+				}
+				elseif(wParam == 0x12){
+					if(this.onResuming){
+						this.onPowerResuming(true) //自动
+					}
+				}
+			}
+		}
+	};
+	close = function(){
+		if(this.handle){
+			::User32.UnregisterPowerSettingNotification(this.handle);
+			this.handle = null;
+		}
+	};
+}
+
+/**intellisense()
+sys.power.notification = 用于注册接收电源设置或状态变更事件的通知窗体
+sys.power.notification( = 注册接收电源设置或状态变更事件的通知窗口，\n相关文档： https://docs.microsoft.com/en-us/windows/win32/power/power-setting-guids
+sys.power.notification(.(winform,guid,dataStruct) = 参数 @winform 必须指定父窗口,\n参数 @guid 可用字符串或 win.guid 对象指定事件 GUID，\n可选用参数 @dataStruct 指定解析回调参数值的结构体。\n如果结构体包含 value 字段，则回调参数值为 value 字段值。\n不指定 @dataStruct 则默认为 {INT value}
+sys.power.notification() = !sysPowerNotification.
+end intellisense**/
+
+/**intellisense(!sysPowerNotification)
+onPowerResuming = @onPowerResuming = function(automatic){
+	__/*自低耗电恢复触发此事件，\n系统自动恢复则 automatic 参数为 true，\n用户操作恢复则在数为 false*/
+}
+onPowerStatusChange = @onPowerStatusChange = function(systemPowerStatus){
+	__/*电源状态变更，\n参数为 SYSTEM_POWER_STATUS 结构体，\n请参考该结构体相关资料*/  
+}
+onPowerSettingChange = @onPowerSettingChange = function(guid,data){
+	__/*电源设置或设置状态变更，\n参数为 guid 为设置 GUID，\ndata 为参数值*/  
+}
+end intellisense**/