Função CM_Get_Device_ID_ExA (cfgmgr32.h)

[Começando com Windows 8 e Windows Server 2012, essa função foi preterida. Em vez disso, use CM_Get_Device_ID .]

A função CM_Get_Device_ID_Ex recupera a ID da instância do dispositivo para uma instância de dispositivo especificada em um computador local ou remoto.

Sintaxe

CMAPI CONFIGRET CM_Get_Device_ID_ExA(
  [in]           DEVINST  dnDevInst,
  [out]          PSTR     Buffer,
  [in]           ULONG    BufferLen,
                 ULONG    ulFlags,
  [in, optional] HMACHINE hMachine
);

Parâmetros

[in] dnDevInst

Identificador de instância de dispositivo fornecido pelo chamador associado ao identificador de computador fornecido por hMachine.

[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_Ex 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.

ulFlags

Não usado, deve ser zero.

[in, optional] hMachine

Identificador de computador fornecido pelo chamador ao qual o identificador de instância do dispositivo fornecido pelo chamador está associado.

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 a um computador local ou remoto, consulte CM_Get_Child_Ex.

A funcionalidade para acessar computadores remotos foi removida em Windows 8 e Windows Server 2012 e sistemas operacionais posteriores, portanto, você não pode acessar computadores remotos durante a execução nessas versões do Windows.

Requisitos

Confira também

CM_Get_Child_Ex
CM_Get_Device_ID