Funzione SHOpenRegStreamA (shlwapi.h)

Articolo
11/20/2024

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

Nota Questa funzione è stata sostituita da SHOpenRegStream2. È consigliabile usare SHOpenRegStream2 sempre.

Sintassi

IStream * SHOpenRegStreamA(
  [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 sia per la lettura che per 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 non valido o pszSubkeyo un'impossibilità di aprire il flusso.

Nota In alcune situazioni, ad esempio quando la sottochiave denominata da pszSubkey non esiste o il chiamante non dispone di autorizzazioni sufficienti per accedere alla sottochiave, viene restituito un flusso di lunghezza zero anziché un valore NULL. SHOpenRegStream2 restituisce NULL in tutte le situazioni di errore ed è la funzione preferita per tale motivo.

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

Condividi tramite