Compartir a través de

Función ResUtilGetDwordProperty (resapi.h)

  • Artículo

Recupera una propiedad DWORD de una lista de propiedades y avanza un puntero a la siguiente propiedad de la lista. El tipo PRESUTIL_GET_DWORD_PROPERTY define un puntero a esta función.

Sintaxis

DWORD ResUtilGetDwordProperty(
  [out] LPDWORD               pdwOutValue,
  [in]  const PCLUSPROP_DWORD pValueStruct,
  [in]  DWORD                 dwOldValue,
  [in]  DWORD                 dwMinimum,
  [in]  DWORD                 dwMaximum,
  [out] LPBYTE                *ppPropertyList,
  [out] LPDWORD               pcbPropertyListSize
);

Parámetros

[out] pdwOutValue

Dirección de un puntero en el que se devolverá el valor DWORD de la lista de propiedades.

[in] pValueStruct

Puntero a una estructura de CLUSPROP_DWORD que especifica el valor DWORD que se va a recuperar de la lista de propiedades.

[in] dwOldValue

Especifica el valor anterior de la propiedad .

[in] dwMinimum

Especifica el valor mínimo permitido para la propiedad .

[in] dwMaximum

Especifica el valor máximo permitido para la propiedad .

[out] ppPropertyList

Dirección del puntero al búfer de lista de propiedades que contiene la propiedad DWORD . Este puntero se avanzará al principio de la propiedad siguiente.

[out] pcbPropertyListSize

Puntero al tamaño del búfer de lista de propiedades. El tamaño se disminuirá para tener en cuenta el avance del puntero ppPropertyList .

Valor devuelto

Si las operaciones se realizan correctamente, la función devuelve ERROR_SUCCESS.

Si se produce un error en la operación, la función devuelve un código de error del sistema. A continuación se muestra un posible código de error.

Código devuelto Descripción
ERROR_INVALID_PARAMETER
 Los datos tienen un formato incorrecto.

Comentarios

La función de utilidad ResUtilGetDwordProperty comprueba que el valor devuelto en pdwOutValue está dentro del intervalo especificado por dwMinimum y dwMaximum. Si dwMinimum y dwMaximum se establecen en 0, no se realiza ninguna comprobación de intervalo.

Requisitos

Requisito Value
Cliente mínimo compatible No se admite ninguno
Servidor mínimo compatible Windows Server 2008 Enterprise, Windows Server 2008 Datacenter
Plataforma de destino Windows
Encabezado resapi.h
Library ResUtils.lib
Archivo DLL ResUtils.dll

Consulte también

ResUtilGetBinaryProperty

ResUtilGetMultiSzProperty

ResUtilGetSzProperty