Fonction SHRegSetValue (shlwapi.h)

Article
03/02/2024

Non pris en charge.

Définit une valeur de registre.

Utilisez RegSetValue à sa place.

Syntaxe

LSTATUS SHRegSetValue(
  [in] HKEY    hkey,
  [in] LPCWSTR pszSubKey,
  [in] LPCWSTR pszValue,
  [in] SRRF    srrfFlags,
  [in] DWORD   dwType,
  [in] LPCVOID pvData,
  [in] DWORD   cbData
);

Paramètres

[in] hkey

Type : HKEY

Handle de la clé actuellement ouverte ou de l’une des valeurs prédéfinies suivantes.

HKEY_CLASSES_ROOT

HKEY_CURRENT_CONFIG

HKEY_CURRENT_USER

HKEY_LOCAL_MACHINE

HKEY_PERFORMANCE_DATA

HKEY_USERS

[in] pszSubKey

Type : LPCWSTR

Pointeur vers une chaîne terminée par null qui spécifie le chemin d’accès relatif de hkey à la sous-clé à partir de laquelle récupérer la valeur. Ce paramètre peut être NULL ou une chaîne vide, auquel cas les données sont récupérées à partir de l’emplacement hkey .

[in] pszValue

Type : LPCWSTR

Pointeur vers une chaîne terminée par null qui contient le nom de la valeur. Ce paramètre peut être NULL ou une chaîne vide, auquel cas les données sont récupérées à partir de la valeur Par défaut.

[in] srrfFlags

Type : SRRF

Un ou plusieurs des indicateurs SRRF qui limitent les données à définir. Au moins une valeur de restriction de type (SRRF_RT) doit être spécifiée.

[in] dwType

Type : DWORD

DWORD qui indique le type de données stockées dans la valeur à définir. Lorsque vous utilisez des valeurs par défaut, l’entrée dwType est le type de la valeur par défaut. Pour connaître les valeurs possibles, consultez Types de données du Registre. Si l’indicateur SRRF_NOEXPAND n’est pas défini, REG_EXPAND_SZ types sont automatiquement développés et retournés en tant que REG_SZ. Si les informations de type ne sont pas requises, ce paramètre peut être NULL.

[in] pvData

Type : LPCVOID

Pointeur vers une mémoire tampon qui contient les données de la valeur. Ce paramètre peut avoir la valeur NULL si les données ne sont pas nécessaires.

[in] cbData

Type : DWORD

Taille de la mémoire tampon de données source pvData, en octets. Cette valeur ne peut être NULL que si pvData a la valeur NULL.

Valeur retournée

Type : LONG

Retourne ERROR_SUCCESS en cas de réussite, ou un code d’erreur différent de zéro défini dans Winerror.h dans le cas contraire. Vous pouvez utiliser la fonction FormatMessage avec l’indicateur FORMAT_MESSAGE_FROM_SYSTEM pour récupérer une description générique de l’erreur.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	shlwapi.h (inclure Shlwapi.h)
DLL	Shlwapi.dll

Voir aussi

RegSetKeyValue

Partager via