Função CM_Get_Device_IDW (cfgmgr32.h)

A função CM_Get_Device_ID recupera a ID da instância do dispositivo para uma instância de dispositivo especificada 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_IDW(
  [in]  DEVINST dnDevInst,
  [out] PWSTR   Buffer,
  [in]  ULONG   BufferLen,
  [in]  ULONG   ulFlags
);

Parâmetros

[in] dnDevInst

Identificador de instância de dispositivo fornecido pelo chamador associado ao computador local.

[out] Buffer

Endereço de um buffer para receber uma cadeia de caracteres de ID da instância do dispositivo. O tamanho do buffer necessário pode ser obtido chamando CM_Get_Device_ID_Size e incrementando o valor recebido para permitir espaço para o nulo de terminação da cadeia de caracteres.

[in] BufferLen

Comprimento fornecido pelo chamador, em caracteres, do buffer especificado por Buffer.

[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 acrescenta um terminador NULL à cadeia de caracteres de ID da instância do dispositivo fornecida, a menos que o buffer seja muito pequeno para manter a cadeia de caracteres. Nesse caso, a função fornece a maior parte da cadeia de caracteres do identificador que caberá no buffer e, em seguida, retorna CR_BUFFER_SMALL.

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

Confira também

CM_Get_Child

CM_Get_Device_ID_Ex