Función ResUtilFindMultiSzProperty (resapi.h)

Artículo
03/08/2023

Busca una propiedad de cadena múltiple en una lista de propiedades. El tipo PRESUTIL_FIND_MULTI_SZ_PROPERTY define un puntero a esta función.

Sintaxis

DWORD ResUtilFindMultiSzProperty(
  [in]  const PVOID pPropertyList,
  [in]  DWORD       cbPropertyListSize,
  [in]  LPCWSTR     pszPropertyName,
  [out] LPWSTR      *pszPropertyValue,
  [out] LPDWORD     pcbPropertyValueSize
);

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] 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 *pbPropertyValue) para liberar la memoria asignada. Si no se requiere ningún valor, pase NULL para este parámetro.

[out] pcbPropertyValueSize

Puntero al tamaño, en bytes, del valor devuelto. Si no se requiere ningún tamaño, 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 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 ResUtilFindMultiSzProperty se realiza correctamente, *pbPropertyValue apunta a una copia de los datos almacenados en pPropertyList. Asegúrese de llamar a LocalFree en *pbPropertyValue 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