funzione CM_Get_Log_Conf_Priority_Ex (cfgmgr32.h)

Articolo
02/23/2024

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

La funzione CM_Get_Log_Conf_Priority_Ex ottiene la priorità di configurazione di una configurazione logica specificata in un computer locale o remoto.

Sintassi

CMAPI CONFIGRET CM_Get_Log_Conf_Priority_Ex(
  [in]           LOG_CONF  lcLogConf,
  [out]          PPRIORITY pPriority,
  [in]           ULONG     ulFlags,
  [in, optional] HMACHINE  hMachine
);

Parametri

[in] lcLogConf

Handle fornito dal chiamante a una configurazione logica. Questo handle deve essere stato ottenuto in precedenza chiamando una delle funzioni seguenti:

CM_Add_Empty_Log_Conf

CM_Add_Empty_Log_Conf_Ex

CM_Get_First_Log_Conf

CM_Get_First_Log_Conf_Ex

CM_Get_Next_Log_Conf

CM_Get_Next_Log_Conf_Ex

[out] pPriority

Indirizzo fornito dal chiamante di una posizione per ricevere un valore di priorità di configurazione. Per un elenco di valori di priorità, vedere la descrizione di Priorità per CM_Add_Empty_Log_Conf_Ex.

[in] ulFlags

Non usato, deve essere zero.

[in, optional] hMachine

Handle macchina 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.

Nota A partire da Windows 8, CM_Get_Log_Conf_Priority_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

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

Vedi anche

CM_Get_Log_Conf_Priority

Condividi tramite