Compartir a través de

Función SHOpenRegStream2A (shlwapi.h)

  • Artículo

Abre un valor del Registro y proporciona una secuencia que se puede usar para leer o escribir en el valor. Esta función sustituye a SHOpenRegStream.

Sintaxis

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

Parámetros

[in] hkey

Tipo: HKEY

Necesario. Subárbol, como HKEY_LOCAL_MACHINE, que contiene el valor .

[in, optional] pszSubkey

Tipo: LPCTSTR

Opcional. Puntero a una cadena terminada en null que especifica la subclave que contiene el valor. Este valor puede ser NULL.

[in, optional] pszValue

Tipo: LPCTSTR

Puntero a una cadena terminada en null que especifica el valor al que se va a tener acceso. Este valor puede ser NULL.

[in] grfMode

Tipo: DWORD

Tipo de acceso para la secuencia. Puede ser uno de los siguientes valores:

STGM_READ

Abra la secuencia para leerla.

STGM_WRITE

Abra la secuencia para escribir.

STGM_READWRITE

Abra la secuencia para leer y escribir.

Valor devuelto

Tipo: IStream*

Devuelve un puntero de interfaz IStream si se ejecuta correctamente; de lo contrario, NULL. Un valor NULL puede deberse a varias situaciones, como una clave hkey o pszSubkey no válida, una subclave denominada pszSubkey que no existe, un autor de la llamada sin permisos suficientes para acceder a la subclave o una incapacidad para abrir la secuencia.

Comentarios

La aplicación que realiza la llamada es responsable de llamar al método Release del objeto devuelto cuando ese objeto IStream ya no es necesario.

Nota

El encabezado shlwapi.h define SHOpenRegStream2 como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutro de codificación con código que no es neutral de codificación puede provocar discrepancias que dan lugar a errores de compilación o en tiempo de ejecución. Para obtener más información, vea Convenciones para prototipos de función.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 2000 Professional, Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado shlwapi.h
Library Shlwapi.lib
Archivo DLL Shlwapi.dll (versión 5.0 o posterior)