función CM_Get_Next_Res_Des_Ex (cfgmgr32.h)

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

La función CM_Get_Next_Res_Des_Ex obtiene un identificador para el siguiente descriptor de recursos, de un tipo de recurso especificado, para una configuración lógica en un equipo local o remoto.

Sintaxis

CMAPI CONFIGRET CM_Get_Next_Res_Des_Ex(
  [out]           PRES_DES    prdResDes,
  [in]            RES_DES     rdResDes,
  [in]            RESOURCEID  ForResource,
  [out, optional] PRESOURCEID pResourceID,
  [in]            ULONG       ulFlags,
  [in, optional]  HMACHINE    hMachine
);

Parámetros

[out] prdResDes

Puntero a una ubicación para recibir un identificador de descriptor de recursos.

[in] rdResDes

Identificador proporcionado por el autor de la llamada a un descriptor de recursos o a una configuración lógica. Para obtener más información, vea la siguiente sección Comentarios .

[in] ForResource

Identificador de tipo de recurso proporcionado por el autor de la llamada, que indica el tipo de descriptor de recursos que se solicita. Debe ser una de las constantes con prefijo ResType_ definidas en Cfgmgr32.h.

[out, optional] pResourceID

Puntero a una ubicación para recibir un identificador de tipo de recurso, si ForResource especifica ResType_All. Para cualquier otro valor forResource , los autores de la llamada deben establecerlo en NULL.

[in] ulFlags

No se usa, debe ser cero.

[in, optional] hMachine

Identificador de máquina 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 con prefijo CR_ definidos en Cfgmgr32.h.

Nota A partir de Windows 8, CM_Get_Next_Res_Des_Ex devuelve CR_CALL_NOT_IMPLEMENTED cuando se usa en un escenario wow64. Para solicitar información sobre los recursos de hardware en un equipo local, es necesario implementar una versión nativa de arquitectura de la aplicación mediante las API de recursos de hardware. Por ejemplo: una aplicación AMD64 para sistemas AMD64.

 

Comentarios

Para enumerar los descriptores de recursos de una configuración lógica, comience llamando a CM_Get_Next_Res_Des_Ex con el identificador de la configuración lógica como argumento para rdResDes. Esto obtiene un identificador para el primer descriptor de recursos del tipo especificado por ForResource. A continuación, para cada llamada posterior a CM_Get_Next_Res_Des_Ex, especifique el identificador de descriptor obtenido más recientemente como argumento para rdResDes. Repita hasta que la función devuelva CR_NO_MORE_RES_DES.

Para recuperar la información almacenada en un descriptor de recursos, llame a CM_Get_Res_Des_Data_Ex.

Para modificar la información almacenada en un descriptor de recursos, llame a CM_Modify_Res_Des_Ex.

Los autores de llamadas de CM_Get_Next_Res_Des_Ex deben llamar a CM_Free_Res_Des_Handle para desasignar el identificador del descriptor de recursos, después de que ya no sea necesario.

La funcionalidad para acceder a las máquinas remotas se ha quitado en Windows 8 y sistemas operativos Windows Server 2012 y versiones 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
Archivo DLL	Cfgmgr32.dll

Consulte también

CM_Get_Next_Res_Des