在 Win32 API 的 Cfgmgr32.h 头文件中,CM_Get_Class_PropertyW 函数用于获取指定设备类的属性。以下是该函数的原型:
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