Funzione SHRegGetValueFromHKCUHKLM (shlwapi.h)

[Questa funzione non è più supportata.]

Ottiene le informazioni specificate dal Registro di sistema. Questa funzione verificherà HKEY_CURRENT_USER per le informazioni richieste nella sottochiave specificata. Se le informazioni non esistono nel sottoalbero HKEY_CURRENT_USER, la funzione controlla il sottoalbero HKEY_LOCAL_MACHINE per le stesse informazioni.

Sintassi

LSTATUS SHRegGetValueFromHKCUHKLM(
  [in]      PCWSTR pwszKey,
  [in]      PCWSTR pwszValue,
  [in]      SRRF   srrfFlags,
  [out]     DWORD  *pdwType,
  [in]      void   *pvData,
  [in, out] DWORD  *pcbData
);

Parametri

[in] pwszKey

Tipo: PCWSTR

Puntatore a una stringa Unicode con terminazione null che specifica il percorso della chiave del Registro di sistema.

[in] pwszValue

Tipo: PCWSTR

Puntatore a una stringa Unicode con terminazione null che specifica il valore della chiave. Questo valore può essere NULL, in cui i dati vengono recuperati dal valore predefinito.

[in] srrfFlags

Tipo: SRRF

Costanti del flag SRRF . Se vengono usati più flag, possono essere combinati usando un OR bit per bit. Questi flag vengono usati per limitare il tipo di dati restituiti. Questo valore non può essere 0.

[out] pdwType

Tipo: DWORD*

Quando questa funzione restituisce, contiene un puntatore a un DWORD che riceve un codice che indica il tipo di dati archiviati nel valore specificato. Questa opzione può essere impostata su NULL se non sono necessarie informazioni sul tipo. Se questo valore non è NULL e il flag di SRRF_NOEXPAND non è stato impostato, i tipi di dati di REG_EXPAND_SZ verranno restituiti come REG_SZ poiché vengono espansi automaticamente in questo metodo.

[in] pvData

Tipo: LPCVOID

Puntatore a un buffer contenente i dati del valore. Questo parametro può essere NULL se i dati non sono necessari. Questo valore deve contenere le dimensioni del buffer pvData nella voce. Se pvData è NULL (o se pvData non è NULL, ma troppo piccolo di un buffer per contenere i dati del Registro di sistema), in uscita conterrà le dimensioni necessarie per contenere i dati del Registro di sistema.

[in, out] pcbData

Tipo: DWORD*

Quando questa funzione restituisce, contiene un puntatore alle dimensioni dei dati, in byte.

Valore restituito

Tipo: LONG

In caso di esito positivo, questa funzione restituisce ERROR_SUCCESS e tutti i parametri richiesti. Restituisce ERROR_MORE_DATA se la funzione ha esito negativo a causa di spazio insufficiente in un pvData non NULL specificato. In questo caso solo pdwType e pcbData possono contenere dati validi, pvData non sarà definito. In caso contrario, restituisce un codice di errore diverso da zero definito in Winerror.h . È possibile usare la funzione FormatMessage con il flag FORMAT_MESSAGE_FROM_SYSTEM per recuperare una descrizione generica dell'errore.

Requisiti