Fonction ResUtilGetMultiSzProperty (resapi.h)

Article
03/01/2024

Récupère une propriété de chaîne multiple à partir d’une liste de propriétés et avance un pointeur vers la propriété suivante dans la liste. Le type PRESUTIL_GET_MULTI_SZ_PROPERTY définit un pointeur vers cette fonction.

Syntaxe

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

Paramètres

[out] ppszOutValue

Adresse d’un pointeur dans lequel la valeur de chaîne multiple de la liste de propriétés sera retournée.

[out] pcbOutValueSize

Pointeur vers la taille de la valeur de sortie.

[in] pValueStruct

Pointeur vers une structure CLUSPROP_MULTI_SZ spécifiant la valeur de plusieurs chaînes à récupérer à partir de la liste de propriétés.

[in, optional] pszOldValue

Pointeur vers la valeur précédente de la propriété .

[in] cbOldValueSize

Pointeur vers la longueur de la valeur précédente de la propriété.

[in, out] ppPropertyList

Adresse du pointeur vers la mémoire tampon de liste de propriétés contenant la propriété de plusieurs chaînes. Ce pointeur est avancé jusqu’au début de la propriété suivante.

[in, out] pcbPropertyListSize

Pointeur vers la taille de la mémoire tampon de liste de propriétés. La taille est décrémentée pour tenir compte de l’avance du pointeur ppPropertyList .

Valeur retournée

Si les opérations réussissent, la fonction retourne ERROR_SUCCESS.

Si l’opération échoue, la fonction retourne un code d’erreur système. Voici un code d’erreur possible.

Code de retour	Description
ERROR_INVALID_PARAMETER	La mise en forme des données est incorrecte.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Aucun pris en charge
Serveur minimal pris en charge	Windows Server 2008 Entreprise, Windows Server 2008 Datacenter
Plateforme cible	Windows
En-tête	resapi.h
Bibliothèque	ResUtils.lib
DLL	ResUtils.dll

Voir aussi

ResUtilGetBinaryProperty

ResUtilGetDwordProperty

ResUtilGetSzProperty

Partager via