Compartir a través de


Función ResUtilGetSzProperty (resapi.h)

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

Sintaxis

DWORD ResUtilGetSzProperty(
  [out]          LPWSTR             *ppszOutValue,
  [in]           const PCLUSPROP_SZ pValueStruct,
  [in, optional] LPCWSTR            pszOldValue,
  [in, out]      LPBYTE             *ppPropertyList,
  [in, out]      LPDWORD            pcbPropertyListSize
);

Parámetros

[out] ppszOutValue

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

[in] pValueStruct

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

[in, optional] pszOldValue

Puntero al valor anterior de la propiedad.

[in, out] ppPropertyList

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

[in, 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 la operación se realiza 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.

Requisitos

   
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

ResUtilGetDwordProperty

ResUtilGetMultiSzProperty