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