funzione CM_Get_Next_Res_Des_Ex (cfgmgr32.h)

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

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

Vedi anche

CM_Get_Next_Res_Des