CM_Get_Class_NameW 函数是 Windows 配置管理器 (Configuration Manager) 提供的一个函数，用于获取指定设备类 GUID 的友好名称。在 Cfgmgr32.h 头文件中，CM_Get_Class_NameW 函数的原型通常如下：
CMAPI CONFIGRET WINAPI CM_Get_Class_NameW(
  _In_  LPGUID ClassGuid,
  _Out_writes_opt_(*pulLength) LPWSTR Buffer,
  _Inout_ PULONG pulLength,
  _In_  ULONG ulFlags
);

其中：

  •  ClassGuid 是指向设备类 GUID 的指针。

  •  Buffer 是指向接收设备类友好名称的缓冲区的指针。可以为 NULL，用于查询所需缓冲区大小。

  •  pulLength 是指向一个变量，用于输入缓冲区大小和输出实际缓冲区大小。

  •  ulFlags 是保留参数，必须为0。


这个函数的作用是获取设备类的友好名称。如果成功，返回 CR_SUCCESS；否则，返回相应的错误码，可以使用 CM_Get_Last_Error 函数获取详细的错误信息。

以下是一个示例代码：
#include <windows.h>
#include <Cfgmgr32.h>
#include <tchar.h>

int main() {
    CONFIGRET cr;
    GUID classGuid = { /* your class GUID here */ };
    ULONG bufferSize = 0;

    // Query the required buffer size
    cr = CM_Get_Class_NameW(&classGuid, NULL, &bufferSize, 0);
    if (cr != CR_SUCCESS && cr != CR_BUFFER_SMALL) {
        // Handle error
        return 1;
    }

    // Allocate buffer
    LPWSTR buffer = (LPWSTR)malloc(bufferSize * sizeof(WCHAR));
    if (buffer == NULL) {
        // Handle memory allocation error
        return 1;
    }

    // Get the class name
    cr = CM_Get_Class_NameW(&classGuid, buffer, &bufferSize, 0);
    if (cr == CR_SUCCESS) {
        // Use the class name
        _tprintf(_T("Class Name: %s\n"), buffer);
    } else {
        // Handle error
    }

    // Cleanup
    free(buffer);

    return 0;
}

请确保在使用时将 classGuid 替换为实际的设备类 GUID。


转载请注明出处：http://www.zyzy.cn/article/detail/24295/Win32 API/Cfgmgr32.h/CM_Get_Class_NameW