Función SHOpenRegStreamA (shlwapi.h)

Obsolescente. 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 * SHOpenRegStreamA(
  [in]           HKEY   hkey,
  [in, optional] LPCSTR pszSubkey,
  [in, optional] LPCSTR pszValue,
  [in]           DWORD  grfMode
);

Parámetros

[in] hkey

Tipo: HKEY de

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

[in, optional] pszSubkey

Tipo: LPCTSTR de

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 de

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 de

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

STGM_READ

Abra la secuencia para leer.

STGM_WRITE

Abra la secuencia para escribir.

STGM_READWRITE

Abra la secuencia para leer y escribir.

Valor devuelto

Tipo: de IStream de

Devuelve un puntero de interfaz IStream si se ejecuta correctamente; De lo contrario, null. Un valor NULL puede deberse a varias situaciones, incluida una hkey no válida o pszSubkeyo 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.

 

Observaciones

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

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 neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Conventions for Function Prototypes.

Requisitos

Requisito	Valor
cliente mínimo admitido	Windows 2000 Professional, Windows XP [solo aplicaciones de escritorio]
servidor mínimo admitido	Windows 2000 Server [solo aplicaciones de escritorio]
de la plataforma de destino de	Windows
encabezado de	shlwapi.h
biblioteca de	Shlwapi.lib
DLL de	Shlwapi.dll (versión 4.71 o posterior)