función CM_Free_Res_Des_Ex (cfgmgr32.h)

  • Artículo

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

La función CM_Free_Res_Des_Ex quita un descriptor de recursos de una configuración lógica en un equipo local o remoto.

Sintaxis

CMAPI CONFIGRET CM_Free_Res_Des_Ex(
  [out]          PRES_DES prdResDes,
  [in]           RES_DES  rdResDes,
  [in]           ULONG    ulFlags,
  [in, optional] HMACHINE hMachine
);

Parámetros

[out] prdResDes

Ubicación proporcionada por el autor de la llamada para recibir un identificador al descriptor de recursos anterior de la configuración. Este parámetro puede ser NULL. Para obtener más información, vea la siguiente sección Comentarios .

[in] rdResDes

Identificador proporcionado por el autor de la llamada al descriptor de recursos que se va a quitar. Este identificador debe haberse obtenido previamente llamando a una de las siguientes funciones:

CM_Add_Res_Des

CM_Add_Res_Des_Ex

CM_Get_Next_Res_Des

CM_Get_Next_Res_Des_Ex

CM_Modify_Res_Des

CM_Modify_Res_Des_Ex

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

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

Comentarios

Los descriptores de recursos para cada configuración se almacenan en una matriz. Si especifica una dirección para prdResDes, CM_Free_Res_Des devuelve un identificador al descriptor de recursos anterior, en la matriz, al que se quitó. Si el identificador especificado por rdResDes representa el descriptor de recursos ubicado primero en la matriz, prdResDes recibe un identificador para la configuración lógica.

Tenga en cuenta que al llamar a CM_Free_Res_Des_Ex libera el descriptor de recursos, pero no el identificador del descriptor. Para liberar el identificador, llame a CM_Free_Res_Des_Handle_Ex.

Los autores de llamadas de esta función deben tener SeLoadDriverPrivilege. (Los privilegios se describen en la documentación de Microsoft Windows SDK).

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
Archivo DLL Cfgmgr32.dll

Consulte también

CM_Free_Res_Des