função CM_Get_Device_ID_Size (cfgmgr32.h)

  • Artigo

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

Confira também

CM_Get_Child

CM_Get_Device_ID

CM_Get_Device_ID_Size_Ex