funzione CM_Open_Device_Interface_Key_ExW (cfgmgr32.h)

Articolo
11/20/2024

[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 aprire la sottochiave del Registro di sistema.

[in] samDesired

Accesso alla sottochiave del Registro di sistema richiesto.

[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 HKEY che riceverà la chiave aperta al termine dell'operazione.

[in] ulFlags

Riservato. Deve essere impostato su zero.

[in, optional] hMachine

Handle computer fornito dal chiamante, ottenuto da una chiamata precedente a CM_Connect_Machine.

Nota L'uso di questa funzione per accedere ai computer remoti non è supportato a partire da Windows 8 e Windows Server 2012, perché questa funzionalità è stata rimossa.

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.

Osservazioni

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 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	Disponibile in Microsoft Windows 10 e versioni successive di Windows.
piattaforma di destinazione	Desktop
intestazione	cfgmgr32.h (include Cfgmgr32.h)
libreria	Cfgmgr32.lib

Vedere anche

CM_Connect_Machine

SetupDiOpenDeviceInterfaceRegKey

Condividi tramite