funzione CM_Get_Next_Res_Des_Ex (cfgmgr32.h)

Articolo
02/23/2024

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

La funzione CM_Get_Next_Res_Des_Ex ottiene un handle per il descrittore di risorse successivo, di un tipo di risorsa specificato, per una configurazione logica in un computer locale o remoto.

Sintassi

CMAPI CONFIGRET CM_Get_Next_Res_Des_Ex(
  [out]           PRES_DES    prdResDes,
  [in]            RES_DES     rdResDes,
  [in]            RESOURCEID  ForResource,
  [out, optional] PRESOURCEID pResourceID,
  [in]            ULONG       ulFlags,
  [in, optional]  HMACHINE    hMachine
);

Parametri

[out] prdResDes

Puntatore a una posizione per ricevere un handle descrittore di risorse.

[in] rdResDes

Handle fornito dal chiamante a un descrittore di risorse o a una configurazione logica. Per altre informazioni, vedere la sezione Osservazioni seguenti.

[in] ForResource

Identificatore del tipo di risorsa fornito dal chiamante, che indica il tipo di descrittore di risorsa richiesto. Questa deve essere una delle costanti con prefisso ResType_ definite in Cfgmgr32.h.

[out, optional] pResourceID

Puntatore a un percorso per ricevere un identificatore di tipo di risorsa, se ForResource specifica ResType_All. Per qualsiasi altro valore ForResource , i chiamanti devono impostare questo valore su NULL.

[in] ulFlags

Non usato, deve essere zero.

[in, optional] hMachine

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

Nota A partire da Windows 8, CM_Get_Next_Res_Des_Ex restituisce CR_CALL_NOT_IMPLEMENTED quando viene 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

Per enumerare i descrittori di risorse di una configurazione logica, iniziare chiamando CM_Get_Next_Res_Des_Ex con l'handle della configurazione logica come argomento per rdResDes. In questo modo viene ottenuto un handle per il primo descrittore di risorsa del tipo specificato da ForResource. Quindi per ogni chiamata successiva a CM_Get_Next_Res_Des_Ex, specificare l'handle descrittore ottenuto più di recente come argomento per rdResDes. Ripetere fino a quando la funzione restituisce CR_NO_MORE_RES_DES.

Per recuperare le informazioni archiviate in un descrittore di risorse, chiamare CM_Get_Res_Des_Data_Ex.

Per modificare le informazioni archiviate in un descrittore di risorse, chiamare CM_Modify_Res_Des_Ex.

I chiamanti di CM_Get_Next_Res_Des_Ex devono chiamare CM_Free_Res_Des_Handle per deallocare l'handle del descrittore di risorse, dopo che non è più necessario.

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 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_Next_Res_Des

Condividi tramite