función CM_Enumerate_Enumerators_ExW (cfgmgr32.h)

[A partir de Windows 8 y Windows Server 2012, esta función ha quedado en desuso. Use CM_Enumerate_Enumerators en su lugar.]

La función CM_Enumerate_Enumerators_Ex enumera los enumeradores de dispositivos de un equipo local o remoto, proporcionando el nombre de cada enumerador.

Sintaxis

CMAPI CONFIGRET CM_Enumerate_Enumerators_ExW(
  [in]           ULONG    ulEnumIndex,
  [out]          PWSTR    Buffer,
  [in, out]      PULONG   pulLength,
  [in]           ULONG    ulFlags,
  [in, optional] HMACHINE hMachine
);

Parámetros

[in] ulEnumIndex

Índice proporcionado por el autor de la llamada en la lista de enumeradores de dispositivos de la máquina. Para obtener más información, vea la siguiente sección Comentarios .

[out] Buffer

Dirección de un búfer para recibir un nombre de enumerador. Este búfer debe tener un tamaño MAX_DEVICE_ID_LEN (o, establezca Buffer en cero y obtenga la longitud real del nombre en la ubicación a la que hace referencia puLength).

[in, out] pulLength

Dirección proporcionada por el autor de la llamada de una ubicación para contener el tamaño del búfer. El autor de la llamada proporciona la longitud del búfer al que apunta buffer. La función reemplaza este valor por el tamaño real de la cadena de nombre del enumerador. Si la longitud del búfer proporcionada por el autor de la llamada es demasiado pequeña, la función proporciona el tamaño de búfer necesario y devuelve CR_BUFFER_SMALL.

[in] ulFlags

No se usa, debe ser cero.

[in, optional] hMachine

Identificador de equipo proporcionado por el autor de la llamada, obtenido de una llamada anterior a CM_Connect_Machine.

Nota No se admite el uso de esta función para acceder a máquinas remotas a partir de Windows 8 y Windows Server 2012, ya que esta funcionalidad se ha quitado.

 

Valor devuelto

Si la operación se realiza correctamente, la función devuelve CR_SUCCESS. De lo contrario, devuelve uno de los códigos de error CR_ prefijo definidos en Cfgmgr32.h.

Comentarios

Para enumerar los enumeradores de dispositivos locales o de un equipo remoto, llame a CM_Enumerate_Enumerators_Ex repetidamente, empezando por un valor de índice ulEnumIndex de cero e incremente el valor de índice con cada llamada posterior hasta que la función devuelva CR_NO_SUCH_VALUE.

Una vez obtenidos los nombres del enumerador, los nombres se pueden usar como entrada para CM_Get_Device_ID_List.

La funcionalidad para acceder a las máquinas remotas se ha quitado en Windows 8 y Windows Server 2012 y sistemas operativos posteriores, por lo que no se puede acceder a las máquinas remotas cuando se ejecutan en estas versiones de Windows.

Requisitos

Requisito	Value
Cliente mínimo compatible	Disponible en Microsoft Windows 2000 y versiones posteriores de Windows.
Plataforma de destino	Escritorio
Encabezado	cfgmgr32.h (incluya Cfgmgr32.h)
Library	Cfgmgr32.lib

Consulte también

CM_Enumerate_Enumerators