Partager via


Fonction ResUtilGetSzProperty (resapi.h)

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

Syntaxe

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

Paramètres

[out] ppszOutValue

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

[in] pValueStruct

Pointeur vers une structure CLUSPROP_SZ spécifiant la valeur de chaîne à 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, out] ppPropertyList

Adresse du pointeur vers la mémoire tampon de liste de propriétés contenant la propriété string. Ce pointeur est avancé 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 sera décrémentée pour tenir compte de l’avance du pointeur ppPropertyList .

Valeur retournée

Si l’opération réussit, 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.

Spécifications

   
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

ResUtilGetMultiSzProperty