Partager via


Fonction OpenRegStream (shlobj_core.h)

[OpenRegStream est disponible pour une utilisation dans les systèmes d’exploitation spécifiés dans la section Configuration requise. Il sera peut-être modifié ou indisponible dans les versions ultérieures. Utilisez plutôt SHOpenRegStream2 ou SHOpenRegStream.]

Ouvre une valeur de Registre et fournit une interface IStream qui peut être utilisée pour lire ou écrire dans la valeur.

Syntaxe

IStream * OpenRegStream(
  [in]           HKEY   hkey,
  [in, optional] PCWSTR pszSubkey,
  [in, optional] PCWSTR pszValue,
                 DWORD  grfMode
);

Paramètres

[in] hkey

Type : HKEY

Handle de la clé actuellement ouverte.

[in, optional] pszSubkey

Type : PCWSTR

Chaîne Unicode terminée par null qui spécifie le nom de la sous-clé.

[in, optional] pszValue

Type : PCWSTR

Chaîne Unicode terminée par null qui spécifie la valeur à accéder.

grfMode

Type : DWORD

Type d’accès pour le flux. Il peut s’agir de l’une des valeurs suivantes.

STGM_READ

Ouvrez le flux pour la lecture.

STGM_WRITE

Ouvrez le flux pour l’écriture.

STGM_READWRITE

Ouvrez le flux pour la lecture et l’écriture.

Valeur retournée

Type : IStream*

Retourne l’adresse d’une interface IStream en cas de réussite, ou NULL dans le cas contraire.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2003 [applications de bureau uniquement]
Plateforme cible Windows
En-tête shlobj_core.h (inclure Shlobj.h)
Bibliothèque Shell32.lib
DLL Shell32.dll (version 5.0 ou ultérieure)