funzione CM_Add_Empty_Log_Conf_Ex (cfgmgr32.h)

Articolo
02/23/2024

[A partire da Windows 8 e Windows Server 2012, questa funzione è stata deprecata. Usare invece CM_Add_Empty_Log_Conf .]

La funzione CM_Add_Empty_Log_Conf_Ex crea una configurazione logica vuota, per un tipo di configurazione specificato e un'istanza del dispositivo specificata, sia nel computer locale che in un computer remoto.

Sintassi

CMAPI CONFIGRET CM_Add_Empty_Log_Conf_Ex(
  [out]          PLOG_CONF plcLogConf,
  [in]           DEVINST   dnDevInst,
  [in]           PRIORITY  Priority,
  [in]           ULONG     ulFlags,
  [in, optional] HMACHINE  hMachine
);

Parametri

[out] plcLogConf

Puntatore a una posizione per ricevere l'handle a una configurazione logica vuota.

[in] dnDevInst

Handle dell'istanza del dispositivo fornita dal chiamante associato all'handle del computer fornito da hMachine.

[in] Priority

Valore di priorità di configurazione fornito dal chiamante. Per un elenco di valori, vedere la descrizione della priorità per CM_Add_Empty_Log_Conf.

[in] ulFlags

Flag forniti dal chiamante che specificano il tipo di configurazione logica. Per un elenco di flag, vedere la descrizione ulFlags description for CM_Add_Empty_Log_Conf.

[in, optional] hMachine

Handle del computer fornito dal chiamante a cui è associato l'handle dell'istanza del dispositivo fornita dal chiamante.

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.

Nota A partire da Windows 8, CM_Add_Empty_Log_Conf_Ex restituisce CR_CALL_NOT_IMPLEMENTED se usato in uno scenario Wow64. Per richiedere informazioni sulle risorse hardware in un computer locale, è necessario implementare una versione nativa dell'architettura dell'applicazione usando le API delle risorse hardware. Ad esempio: un'applicazione AMD64 per sistemi AMD64.

Commenti

La chiamata CM_Add_Empty_Log_Conf_Ex può causare l'invalidità degli handle restituiti da CM_Get_First_Log_Conf_Ex e CM_Get_Next_Log_Conf_Ex . Pertanto, se si vogliono ottenere configurazioni logiche dopo aver chiamato CM_Add_Empty_Log_Conf_Ex, il codice deve chiamare di nuovo CM_Get_First_Log_Conf_Ex e iniziare alla prima configurazione.

Per rimuovere una configurazione logica creata da CM_Add_Empty_Log_Conf_Ex, chiamare CM_Free_Log_Conf_Ex.

La maniglia ricevuta in plcLogConf deve essere liberata esplicitamente chiamando CM_Free_Log_Conf_Handle.

I chiamanti di questa funzione devono avere SeLoadDriverPrivilege. I privilegi sono descritti nella documentazione di Microsoft Windows SDK.

Per informazioni sull'uso di handle di istanza del dispositivo associati a un computer locale o remoto, vedere CM_Get_Child_Ex.

Le funzionalità per accedere ai computer remoti sono state rimosse in Windows 8 e Windows Server 2012 e sistemi operativi successivi, pertanto non è possibile accedere ai computer remoti durante l'esecuzione in queste versioni di Windows.

Requisiti

Requisito	Valore
Client minimo supportato	Disponibile in Microsoft Windows 2000 e versioni successive di Windows.
Piattaforma di destinazione	Desktop
Intestazione	cfgmgr32.h (include Cfgmgr32.h)
Libreria	Cfgmgr32.lib
DLL	Cfgmgr32.dll