Función SHOpenRegStreamW (shlwapi.h)

  • Artículo

Desusado. Abre un valor del Registro y proporciona una secuencia que se puede usar para leer o escribir en el valor.

Nota Esta función se ha reemplazado por SHOpenRegStream2. Se recomienda usar SHOpenRegStream2 en todo momento.
 

Sintaxis

IStream * SHOpenRegStreamW(
  [in]           HKEY    hkey,
  [in, optional] LPCWSTR pszSubkey,
  [in, optional] LPCWSTR 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, o una incapacidad para abrir la secuencia.

Nota En algunas situaciones, como cuando la subclave denominada por pszSubkey no existe o el autor de la llamada no tiene permisos suficientes para acceder a la subclave, se devuelve una secuencia de longitud cero en lugar de un valor NULL . SHOpenRegStream2 devuelve NULL en todas las situaciones de error y es la función preferida por ese motivo.
 

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 SHOpenRegStream 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 4.71 o posterior)