função CM_Enumerate_EnumeratorsW (cfgmgr32.h)
A função CM_Enumerate_Enumerators enumera os enumeradores de dispositivo do computador local fornecendo o nome de cada enumerador.
Sintaxe
CMAPI CONFIGRET CM_Enumerate_EnumeratorsW(
[in] ULONG ulEnumIndex,
[out] PWSTR Buffer,
[in, out] PULONG pulLength,
[in] ULONG ulFlags
);
Parâmetros
[in] ulEnumIndex
Índice fornecido pelo chamador na lista de enumeradores de dispositivo do computador. Para obter mais informações, consulte a seção Comentários a seguir.
[out] Buffer
Endereço de um buffer para receber um nome de enumerador. Esse buffer deve ser MAX_DEVICE_ID_LEN dimensionado (ou, definir Buffer como zero e obter o comprimento real do nome no local referenciado por puLength).
[in, out] pulLength
Endereço fornecido pelo chamador de um local para manter o tamanho do buffer. O chamador fornece o comprimento do buffer apontado pelo Buffer. A função substitui esse valor pelo tamanho real da cadeia de caracteres de nome do enumerador. Se o comprimento do buffer fornecido pelo chamador for muito pequeno, a função fornecerá o tamanho do buffer necessário e retornará CR_BUFFER_SMALL.
[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
Para enumerar os enumeradores de dispositivo do computador local, chame CM_Enumerate_Enumerators repetidamente, começando com um valor de índice ulEnumIndex igual a zero. e incrementando o valor de índice com cada chamada subsequente até que a função retorne CR_NO_SUCH_VALUE.
Depois que os nomes do enumerador forem obtidos, os nomes poderão ser usados como entrada para CM_Get_Device_ID_List.
Requisitos
| Requisito | Valor |
|---|---|
| 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 |