CMAPI CONFIGRET WINAPI CM_Get_Class_PropertyW(
_In_ LPGUID ClassGuid,
_In_ DEVPROPKEY PropertyKey,
_Out_ PDEVPROPTYPE PropertyType,
_Out_writes_bytes_opt_(*PropertyBufferSize) PBYTE PropertyBuffer,
_Inout_ PULONG PropertyBufferSize,
_In_ ULONG ulFlags,
_In_opt_ HMACHINE hMachine
);
函数参数说明如下:
- ClassGuid: 指向设备类的 GUID 的指针。
- PropertyKey: 设备属性键,标识要获取的设备类属性。
- PropertyType: 用于接收属性值类型的指针。
- PropertyBuffer: 用于接收属性值的缓冲区指针。可以为 NULL,用于查询所需缓冲区大小。
- PropertyBufferSize: 输入时为缓冲区大小,输出时为实际写入的缓冲区大小。
- ulFlags: 保留,必须为0。
- hMachine: 机器句柄,指示函数在哪台机器上执行。可以为 NULL,表示本地机器。
如果函数成功执行,将返回 CR_SUCCESS;否则,将返回相应的错误码,可以使用 CM_Get_Last_Error 函数获取详细的错误信息。
以下是一个示例代码:
#include <windows.h>
#include <Cfgmgr32.h>
int main() {
CONFIGRET cr;
GUID classGuid = { /* your class GUID here */ };
DEVPROPKEY propertyKey = { /* your property key here */ };
DEVPROPTYPE propertyType;
ULONG propertyBufferSize = 0;
// Query the required property buffer size
cr = CM_Get_Class_PropertyW(&classGuid, propertyKey, &propertyType, NULL, &propertyBufferSize, 0, NULL);
if (cr != CR_SUCCESS && cr != CR_BUFFER_SMALL) {
// Handle error
return 1;
}
// Allocate property buffer
PBYTE propertyBuffer = (PBYTE)malloc(propertyBufferSize);
if (propertyBuffer == NULL) {
// Handle memory allocation error
return 1;
}
// Get the property value
cr = CM_Get_Class_PropertyW(&classGuid, propertyKey, &propertyType, propertyBuffer, &propertyBufferSize, 0, NULL);
if (cr == CR_SUCCESS) {
// Use the property value
// ...
} else {
// Handle error
}
// Cleanup
free(propertyBuffer);
return 0;
}
请确保在使用时将 classGuid 和 propertyKey 替换为实际的设备类 GUID 和属性键。
转载请注明出处:http://www.zyzy.cn/article/detail/24296/Win32 API/Cfgmgr32.h/CM_Get_Class_PropertyW