função CM_Get_Device_ID_Size_Ex (cfgmgr32.h)

[A partir do Windows 8 e do Windows Server 2012, essa função foi preterida. Em vez disso, use CM_Get_Device_ID_Size .]

A função CM_Get_Device_ID_Size_Ex recupera o tamanho do buffer necessário para manter uma ID de instância de dispositivo para uma instância de dispositivo em um computador local ou remoto.

Sintaxe

CMAPI CONFIGRET CM_Get_Device_ID_Size_Ex(
  [out]          PULONG   pulLen,
  [in]           DEVINST  dnDevInst,
  [in]           ULONG    ulFlags,
  [in, optional] HMACHINE hMachine
);

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.

[in, optional] hMachine

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

Nota Não há suporte para o uso dessa função para acessar computadores remotos a partir do Windows 8 e do Windows Server 2012, pois essa funcionalidade foi removida.

 

Valor retornado

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_Ex deve ser chamada para determinar o tamanho do buffer exigido pelo CM_Get_Device_ID_Ex.

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

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

Requisitos

Cliente mínimo com suporte	Disponível no Microsoft Windows 2000 e versões posteriores do Windows.
Plataforma de Destino	Área de Trabalho
Cabeçalho	cfgmgr32.h (inclua Cfgmgr32.h)
Biblioteca	Cfgmgr32.lib
DLL	Cfgmgr32.dll

Confira também

CM_Get_Child_Ex

CM_Get_Device_ID_Ex

CM_Get_Device_ID_Size