Funzione SHOpenRegStream2A (shlwapi.h)

Articolo
11/20/2024

Apre un valore del Registro di sistema e fornisce un flusso che può essere usato per leggere o scrivere nel valore . Questa funzione sostituisce SHOpenRegStream.

Sintassi

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

Parametri

[in] hkey

Tipo: HKEY

Obbligatorio. Sottoalbero, ad esempio HKEY_LOCAL_MACHINE, che contiene il valore .

[in, optional] pszSubkey

Tipo: LPCTSTR

Opzionale. Puntatore a una stringa con terminazione Null che specifica la sottochiave che contiene il valore. Questo valore può essere NULL.

[in, optional] pszValue

Tipo: LPCTSTR

Puntatore a una stringa con terminazione Null che specifica il valore a cui accedere. Questo valore può essere NULL.

[in] grfMode

Tipo: DWORD

Tipo di accesso per il flusso. Può trattarsi di uno dei valori seguenti:

STGM_READ

Aprire il flusso per la lettura.

STGM_WRITE

Aprire il flusso per la scrittura.

STGM_READWRITE

Aprire il flusso per la lettura e la scrittura.

Valore restituito

Tipo: * IStream

Restituisce un puntatore dell'interfaccia IStream se ha esito positivo; in caso contrario, NULL. Un valore null può essere causato da diverse situazioni, tra cui un hkey o pszSubkey, una sottochiave denominata da pszSubkey che non esiste, un chiamante senza autorizzazioni sufficienti per accedere alla sottochiave o un'impossibilità di aprire il flusso.

Osservazioni

L'applicazione chiamante è responsabile della chiamata del metodo Release dell'oggetto restituito quando tale oggetto IStream non è più necessario.

Nota

L'intestazione shlwapi.h definisce SHOpenRegStream2 come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows 2000 Professional, Windows XP [solo app desktop]
server minimo supportato	Windows 2000 Server [solo app desktop]
piattaforma di destinazione	Finestre
intestazione	shlwapi.h
libreria	Shlwapi.lib
dll	Shlwapi.dll (versione 5.0 o successiva)

Condividi tramite