funzione CM_Open_Device_Interface_Key_ExW (cfgmgr32.h)
[A partire da Windows 8 e Windows Server 2012, questa funzione è stata deprecata. Usare invece CM_Open_Device_Interface_Key .]
La funzione CM_Open_Device_Interface_Key_ExW apre la sottochiave del Registro di sistema usata dalle applicazioni e dai driver per archiviare informazioni specifiche di un'interfaccia del dispositivo.
Sintassi
CMAPI CONFIGRET CM_Open_Device_Interface_Key_ExW(
[in] LPCWSTR pszDeviceInterface,
[in] REGSAM samDesired,
[in] REGDISPOSITION Disposition,
[out] PHKEY phkDeviceInterface,
[in] ULONG ulFlags,
[in, optional] HMACHINE hMachine
);
Parametri
[in] pszDeviceInterface
Puntatore a una stringa che identifica l'istanza dell'interfaccia del dispositivo per cui aprire la sottochiave del Registro di sistema.
[in] samDesired
Accesso di sicurezza del Registro di sistema richiesto alla sottochiave del Registro di sistema.
[in] Disposition
Specifica la modalità di apertura della chiave del Registro di sistema. Può essere uno dei valori seguenti:
RegDisposition_OpenAlways
Aprire la chiave, se esistente. In caso contrario, creare la chiave.
RegDisposition_OpenExisting
Aprire la chiave solo se esistente.
[out] phkDeviceInterface
Puntatore a un valore HKEY che riceverà la chiave aperta al termine dell'operazione.
[in] ulFlags
Riservato. Deve essere impostato su zero.
[in, optional] hMachine
Handle macchina fornito dal chiamante, ottenuto da una chiamata precedente a CM_Connect_Machine.
Valore restituito
Se l'operazione ha esito positivo, la funzione restituisce CR_SUCCESS. In caso contrario, restituisce uno dei codici di errore con prefisso CR_ definiti in Cfgmgr32.h.
Commenti
Chiudere l'handle restituito da questa funzione chiamando RegCloseKey.
Nota
L'intestazione cfgmgr32.h definisce CM_Open_Device_Interface_Key_Ex 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 che non è indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzioni.
Requisiti
Requisito | Valore |
---|---|
Client minimo supportato | Disponibile in Microsoft Windows 10 e versioni successive di Windows. |
Piattaforma di destinazione | Desktop |
Intestazione | cfgmgr32.h (include Cfgmgr32.h) |
Libreria | Cfgmgr32.lib |
Vedi anche
Commenti e suggerimenti
https://aka.ms/ContentUserFeedback.
Presto disponibile: Nel corso del 2024 verranno gradualmente disattivati i problemi di GitHub come meccanismo di feedback per il contenuto e ciò verrà sostituito con un nuovo sistema di feedback. Per altre informazioni, vedereInvia e visualizza il feedback per