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 reemplaza SHOpenRegStream .

Sintaxis

IStream * SHOpenRegStream2A(
  [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, como una hkey no válida o pszSubkey, una subclave denominada por pszSubkey que no existe, un llamador sin permisos suficientes para acceder a la subclave o una incapacidad para abrir la secuencia.

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 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 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 5.0 o posterior)