Función ResUtilFindExpandedSzProperty (resapi.h)

Artículo
08/25/2023

Busca un valor de propiedad de cadena expandido en una lista de propiedades. El tipo PRESUTIL_FIND_EXPANDED_SZ_PROPERTY define un puntero a esta función.

Sintaxis

DWORD ResUtilFindExpandedSzProperty(
  [in]            const PVOID pPropertyList,
  [in]            DWORD       cbPropertyListSize,
  [in]            LPCWSTR     pszPropertyName,
  [out, optional] LPWSTR      *pszPropertyValue
);

Parámetros

[in] pPropertyList

Puntero a la lista de propiedades en la que se va a buscar el valor.

[in] cbPropertyListSize

Tamaño en bytes de los datos incluidos en pPropertyList.

[in] pszPropertyName

Puntero a una cadena Unicode terminada en null que contiene el nombre del valor que se va a buscar.

[out, optional] pszPropertyValue

Puntero a un puntero WCHAR a un búfer (asignado por la función) que contiene una copia del valor de propiedad. Debe llamar a LocalFree (en *pszPropertyValue) para liberar la memoria asignada. Si no se requiere ningún valor, pase NULL para este parámetro.

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 muestran los códigos de error posibles.

Código devuelto	Descripción
ERROR_INVALID_DATA	La lista de propiedades tiene un formato incorrecto.
ERROR_NOT_ENOUGH_MEMORY	La función no pudo asignar un búfer en el que devolver el valor de la propiedad.
ERROR_FILE_NOT_FOUND	No se pudo encontrar la propiedad especificada en la lista de propiedades.

Comentarios

Si ResUtilFindExpandSzProperty se realiza correctamente, *pszPropertyValue apunta a una copia de los datos almacenados en pPropertyList. Asegúrese de llamar a LocalFree en *pszPropertyValue para evitar pérdidas de memoria.

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