win.guid 库模块帮助文档

win 成员列表 #

win.guid("GUID、CLSID、ProgID等") #

字符串转换为 GUID,
参数支持ProgID,CLSID,GUID,
失败返回null空值

win.guid() #

创建 GUID 结构体,初始化为空值。

可使用 win.guid.create 函数创建 GUID 结构体并初始化为唯一值。

返回的 win.guid 对象通过 ++ 或 + 操作符连接时会自动转换为字符串。

win.guid 对象可以使用 tostring 函数转换为大写字符串。
tostring 参数 @2 指定是否小写,参数@3指定是否添加大括号,
tostring 参数@2 也可用字符串指定11个数值参数的格式化串,

返回对象:winGuidObject

win.guid(数值,数值,数值,'\x00\x00\x00\x00\x00\x00\x00\x00') #

创建GUID结构体
参数@4也可以改为包含8个字节数值的数组或者展开为8个数值参数

win.guid 成员列表 #

win.guid.create() #

创建 GUID 结构体并初始化为唯一值。

返回对象:winGuidObject

win.guid.fromString("字符串参数") #

字符串转换为 GUID 结构体。
参数支持 ProgID,CLSID,GUID （32 个 16 进制字符以及可选的 4 个短横线）格式字符串,
失败返回 null 空值。

注意 win.guid 对象可以使用 tostring 函数转换为字符串,
tostring 参数 @1 指定是否小写（或指定格式化字符串）,参数 @2 指定是否添加大括号,

返回对象:winGuidObject

win.guid.fromString() #

返回对象:winGuidObject

win.guid.toProgId("字符串参数") #

GUID转换为字符串格式的 ProgId
失败返回null空值

win.guid.valid() #

返回对象:winGuidObject

win.guid.valid(GUID对象) #

判断是否有效GUID对象,
如果参数是ProgID,CLSID,GUID,则尝试转换,
转换成功则返回GUID对象,否则返回空

winGuidObject 成员列表 #

winGuidObject.Data1 #

INT类型

winGuidObject.Data2 #

WORD类型

winGuidObject.Data3 #

WORD类型

winGuidObject.Data4 #

字符串值,也可以指定包含多个字节值的数组

winGuidObject.create() #

初始化为唯一值，返回自身

返回对象:winGuidObject

winGuidObject.fromString("字符串参数") #

字符串转换为 GUID 结构体,返回自身,
也可以直接写到 win.guid 参数中,
可使用 tostring 函数将 GUID 结构体重新转换为字符串
tostring 参数@2指定是否小写,参数@3指定是否添加大括号,
tostring 参数@2 也可用字符串指定11个数值参数的格式化串

返回对象:winGuidObject

winGuidObject.hex() #

转换为 16 进制格式字符串。
可选使用参数 @1 自定义 16 进制前缀字符，默认为空字符串。

winGuidObject.isNull() #

是否等于GUID_NULL，也就是结构体内存的所有字节值为0

winGuidObject.toProgId() #

CLSID转换为ProgId,返回字符串

winGuidObject.toString #

转换为字符串,也支持通过 tostring 自动调用此函数

winGuidObject.toString("%08X%04X%04X%02X%02X%02X%02X%02X%02X%02X%02X") #

转换为字符串,自定义 11 个数值参数的格式化串

winGuidObject.toString("%X") #

转换为 32 位 16 进制字符串，大写，无短横线。
参数 %X" 自动转换为 "%08X%04X%04X%02X%02X%02X%02X%02X%02X%02X%02X"。
也可以写为 tostring(guid,"%X") 。

winGuidObject.toString("%x") #

转换为 32 位 16 进制字符串，小写，无短横线。
参数 %x" 自动转换为 "%08x%04x%04x%02x%02x%02x%02x%02x%02x%02x%02x"。
也可以写为 tostring(guid,"%x") 。

winGuidObject.toString(是否小写,是否添加大括号) #

转换为字符串,生成格式:
00000000-0000-0000-0000-000000000000

winGuidObject.unpack() #

转换并返回 11 个数值

Markdown 格式