funzione CM_Get_DevNode_Status_Ex (cfgmgr32.h)

Articolo
03/13/2024

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

La funzione CM_Get_DevNode_Status_Ex ottiene lo stato di un'istanza del dispositivo dal nodo del dispositivo (devnode) in un albero dei dispositivi locale o remoto.

Sintassi

CMAPI CONFIGRET CM_Get_DevNode_Status_Ex(
  [out]          PULONG   pulStatus,
  [out]          PULONG   pulProblemNumber,
  [in]           DEVINST  dnDevInst,
  [in]           ULONG    ulFlags,
  [in, optional] HMACHINE hMachine
);

Parametri

[out] pulStatus

Indirizzo di una posizione in cui ricevere i flag di bit di stato. La funzione può impostare qualsiasi combinazione dei flag di bit con prefisso DN_ definiti in Cfg.h.

[out] pulProblemNumber

Indirizzo di una posizione per ricevere uno dei valori di problema con prefisso CM_PROB_ definiti in Cfg.h. Utilizzato solo se DN_HAS_PROBLEM è impostato in pulStatus.

[in] dnDevInst

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

[in] ulFlags

Non usato, deve essere zero.

[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.

Commenti

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

Vedi anche

CM_Get_Child_Ex

CM_Get_DevNode_Status

Condividi tramite