fonction CM_Add_Res_Des_Ex (cfgmgr32.h)

Article
02/23/2024

[À compter de Windows 8 et Windows Server 2012, cette fonction a été déconseillée. Utilisez CM_Add_Res_Des à la place.]

La fonction CM_Add_Res_Des_Ex ajoute un descripteur de ressource à une configuration logique. La configuration logique peut se trouver sur l’ordinateur local ou distant.

Syntaxe

CMAPI CONFIGRET CM_Add_Res_Des_Ex(
  [out, optional] PRES_DES   prdResDes,
  [in]            LOG_CONF   lcLogConf,
  [in]            RESOURCEID ResourceID,
  [in]            PCVOID     ResourceData,
  [in]            ULONG      ResourceLen,
  [in]            ULONG      ulFlags,
  [in, optional]  HMACHINE   hMachine
);

Paramètres

[out, optional] prdResDes

Pointeur vers un emplacement pour recevoir un handle vers le nouveau descripteur de ressource.

[in] lcLogConf

Handle fourni par l’appelant à la configuration logique à laquelle le descripteur de ressource doit être ajouté. Ce handle doit avoir été obtenu précédemment en appelant l’une des fonctions suivantes :

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

[in] ResourceID

Identificateur de type de ressource fourni par l’appelant, qui identifie le type de structure fourni par ResourceData. Il doit s’agir de l’une des constantes préfixées ResType_ définies dans Cfgmgr32.h.

[in] ResourceData

Pointeur fourni par l’appelant vers l’une des structures de ressources répertoriées dans le tableau suivant.

ResourceID Paramètre	Structure des ressources
ResType_BusNumber	BUSNUMBER_RESOURCE
ResType_ClassSpecific	CS_RESOURCE
ResType_DevicePrivate	DEVPRIVATE_RESOURCE
ResType_DMA	DMA_RESOURCE
ResType_IO	IO_RESOURCE
ResType_IRQ	IRQ_RESOURCE
ResType_Mem	MEM_RESOURCE
ResType_MfCardConfig	MFCARD_RESOURCE
ResType_PcCardConfig	PCCARD_RESOURCE

[in] ResourceLen

Longueur fournie par l’appelant de la structure pointée vers ResourceData.

[in] ulFlags

Non utilisé, doit être égal à zéro.

[in, optional] hMachine

Handle d’ordinateur fourni par l’appelant, obtenu à partir d’un appel précédent à CM_Connect_Machine ou NULL.

Note L’utilisation de cette fonction pour accéder aux machines distantes n’est pas prise en charge à partir de Windows 8 et Windows Server 2012, car cette fonctionnalité a été supprimée.

Valeur retournée

Si l’opération réussit, la fonction retourne CR_SUCCESS. Sinon, il retourne l’un des codes d’erreur CR_ préfixés définis dans Cfgmgr32.h.

Note À compter de Windows 8, CM_Add_Res_Des_Ex retourne CR_CALL_NOT_IMPLEMENTED lorsqu’il est utilisé dans un scénario Wow64. Pour demander des informations sur les ressources matérielles sur un ordinateur local, il est nécessaire d’implémenter une version native d’architecture de l’application à l’aide des API de ressources matérielles. Par exemple : une application AMD64 pour les systèmes AMD64.

Remarques

Les appelants de CM_Add_Res_Des_Ex doivent appeler CM_Free_Res_Des_Handle pour libérer le handle de descripteur de ressource, une fois qu’il n’est plus nécessaire.

Les appelants de cette fonction doivent avoir SeLoadDriverPrivilege. (Les privilèges sont décrits dans la documentation Microsoft Windows SDK.)

Les fonctionnalités permettant d’accéder aux machines distantes ont été supprimées dans les systèmes d’exploitation Windows 8 et Windows Server 2012 et versions ultérieures, par conséquent, vous ne pouvez pas accéder aux machines distantes lorsque vous exécutez sur ces versions de Windows.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Disponible dans Microsoft Windows 2000 et versions ultérieures de Windows.
Plateforme cible	Desktop (Expérience utilisateur)
En-tête	cfgmgr32.h (inclure Cfgmgr32.h)
Bibliothèque	Cfgmgr32.lib
DLL	Cfgmgr32.dll

Voir aussi

CM_Add_Res_Des

CM_Free_Res_Des_Handle

Partager via