función CM_Modify_Res_Des_Ex (cfgmgr32.h)

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

La función CM_Modify_Res_Des_Ex modifica un descriptor de recursos especificado en un equipo local o remoto.

Sintaxis

CMAPI CONFIGRET CM_Modify_Res_Des_Ex(
  [out]          PRES_DES   prdResDes,
  [in]           RES_DES    rdResDes,
  [in]           RESOURCEID ResourceID,
  [in]           PCVOID     ResourceData,
  [in]           ULONG      ResourceLen,
  [in]           ULONG      ulFlags,
  [in, optional] HMACHINE   hMachine
);

Parámetros

[out] prdResDes

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

[in] rdResDes

Identificador proporcionado por el autor de la llamada al descriptor de recursos que se va a modificar. 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] ResourceID

Identificador de tipo de recurso proporcionado por el autor de la llamada. Debe ser una de las constantes con prefijo ResType_ definidas en Cfgmgr32.h.

[in] ResourceData

Puntero proporcionado por el llamador a un descriptor de recursos, que puede ser una de las estructuras enumeradas en la descripción de resourceData de la función CM_Add_Res_Des_Ex.

[in] ResourceLen

Longitud proporcionada por el autor de la llamada de la estructura a la que apunta ResourceData.

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

Los datos del descriptor de recursos proporcionados por el autor de la llamada reemplazan los datos existentes. Los valores especificados para ResourceID y ResourceLen no tienen que coincidir con el descriptor de recursos existente.

Si el valor especificado para ResourceID es ResType_ClassSpecific, el descriptor de recursos especificado debe ser el último asociado a la configuración lógica.

Los autores de llamadas de CM_Modify_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.

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

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_Modify_Res_Des