función CM_Get_Res_Des_Data_Size_Ex (cfgmgr32.h)

  • Artículo

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

La función CM_Get_Res_Des_Data_Size_Ex obtiene el tamaño del búfer necesario para contener la información contenida en un descriptor de recursos especificado en un equipo local o remoto.

Sintaxis

CMAPI CONFIGRET CM_Get_Res_Des_Data_Size_Ex(
  [out]          PULONG   pulSize,
  [in]           RES_DES  rdResDes,
  [in]           ULONG    ulFlags,
  [in, optional] HMACHINE hMachine
);

Parámetros

[out] pulSize

Dirección proporcionada por el autor de la llamada de una ubicación para recibir el tamaño de búfer necesario.

[in] rdResDes

Identificador proporcionado por el autor de la llamada a un descriptor de recursos, obtenido por una llamada anterior a CM_Get_Next_Res_Des_Ex.

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

El valor de tamaño devuelto representa el tamaño de la estructura de recursos adecuada (consulte CM_Add_Res_Des_Ex). Si el descriptor de recursos reside en una lista de requisitos de recursos, el tamaño devuelto incluye tanto el tamaño de la estructura de recursos como el espacio asignado para las matrices de intervalo asociadas.

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_Res_Des_Data_Size