funzione CM_Is_Version_Available_Ex (cfgmgr32.h)

[A partire da Windows 8 e Windows Server 2012, questa funzione è stata deprecata e non deve essere usata.]

La funzione CM_Is_Version_Available_Ex indica se una versione specificata del Plug and Play (PnP) Configuration Manager DLL (Cfgmgr32.dll) è supportata da un computer locale o remoto.

Sintassi

CMAPI BOOL CM_Is_Version_Available_Ex(
  [in]           WORD     wVersion,
  [in, optional] HMACHINE hMachine
);

Parametri

[in] wVersion

Identifica una versione di Configuration Manager. La versione supportata di Configuration Manager corrisponde direttamente alla versione del sistema operativo. La versione principale viene specificata dal byte ad ordine elevato e la versione secondaria viene specificata dal byte a basso ordine. Ad esempio, 0x0400 specifica la versione 4.0, supportata per impostazione predefinita da Microsoft Windows NT 4.0 e versioni successive di Windows. La versione 0x0501 specifica la versione 5.1, supportata da Windows XP e versioni successive di Windows.

[in, optional] hMachine

Fornisce un handle di computer restituito da 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

La funzione restituisce TRUE se la funzione può connettersi al computer specificato e se il computer supporta la versione specificata. In caso contrario, la funzione restituisce FALSE.

Commenti

Usare questa funzione per determinare se una versione specificata di Configuration Manager è supportata da un computer locale o remoto. Se la versione specificata è supportata, tutte le versioni precedenti e incluse questa versione sono supportate dal computer. È anche possibile usare CM_Is_Version_Available per determinare se il computer locale supporta una versione specifica di Configuration Manager.

La funzionalità per accedere ai computer remoti è stata rimossa in Windows 8 e Windows Server 2012 e sistemi operativi successivi, pertanto non è possibile accedere ai computer remoti quando vengono eseguiti in queste versioni di Windows.

Requisiti

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

Vedi anche

CM_Connect_Machine

CM_Get_Version

CM_Get_Version_Ex

CM_Is_Version_Available