função CM_Get_Device_ID_Size (cfgmgr32.h)
A função CM_Get_Device_ID_Size recupera o tamanho do buffer necessário para manter uma ID de instância do dispositivo para uma instância de dispositivo no computador local.
Observação
No Windows Vista e versões posteriores do Windows, o modelo de propriedade do dispositivo unificado usa a chave de propriedadeDEVPKEY_Device_InstanceId para representar o identificador da instância do dispositivo. Consulte Recuperando um identificador de instância de dispositivo para obter detalhes.
Sintaxe
CMAPI CONFIGRET CM_Get_Device_ID_Size(
[out] PULONG pulLen,
[in] DEVINST dnDevInst,
[in] ULONG ulFlags
);
Parâmetros
[out] pulLen
Recebe um valor que representa o tamanho do buffer necessário, em caracteres.
[in] dnDevInst
Identificador de instância de dispositivo fornecido pelo chamador associado ao computador local.
[in] ulFlags
Não usado, deve ser zero.
Retornar valor
Se a operação for bem-sucedida, a função retornará CR_SUCCESS. Caso contrário, ele retornará um dos códigos de erro prefixados por CR_ definidos em Cfgmgr32.h.
Comentários
A função CM_Get_Device_ID_Size deve ser chamada para determinar o tamanho do buffer exigido por CM_Get_Device_ID.
O valor de tamanho fornecido no local apontado por pulLen é menor que MAX_DEVICE_ID_LEN e não inclui null de terminação da cadeia de caracteres do identificador. Se a instância do dispositivo especificada não existir, a função fornecerá um valor de tamanho igual a zero.
Para obter informações sobre IDs de instância do dispositivo, consulte Cadeias de caracteres de identificação do dispositivo.
Para obter informações sobre como usar identificadores de instância de dispositivo associados ao computador local, consulte CM_Get_Child.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Disponível no Microsoft Windows 2000 e versões posteriores do Windows. |
| Plataforma de Destino | Universal |
| Cabeçalho | cfgmgr32.h (inclua Cfgmgr32.h) |
| Biblioteca | Cfgmgr32.lib; OneCoreUAP.lib no Windows 10 |
| DLL | CfgMgr32.dll |