funzione CM_Get_Res_Des_Data_Size_Ex (cfgmgr32.h)

Articolo
03/08/2023

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

La funzione CM_Get_Res_Des_Data_Size_Ex ottiene le dimensioni del buffer necessarie per contenere le informazioni contenute in un descrittore di risorse specificato in un computer locale o remoto.

Sintassi

CMAPI CONFIGRET CM_Get_Res_Des_Data_Size_Ex(
  [out]          PULONG   pulSize,
  [in]           RES_DES  rdResDes,
  [in]           ULONG    ulFlags,
  [in, optional] HMACHINE hMachine
);

Parametri

[out] pulSize

Indirizzo fornito dal chiamante di una posizione per ricevere le dimensioni del buffer necessarie.

[in] rdResDes

Handle fornito dal chiamante a un descrittore di risorse, ottenuto da una chiamata precedente a CM_Get_Next_Res_Des_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_Res_Des_Data_Size_Ex restituisce CR_CALL_NOT_IMPLEMENTED 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

Il valore delle dimensioni restituite rappresenta le dimensioni della struttura di risorse appropriata (vedere CM_Add_Res_Des_Ex). Se il descrittore di risorse risiede in un elenco dei requisiti delle risorse, le dimensioni restituite includono sia le dimensioni della struttura delle risorse che lo spazio allocato per le matrici di intervalli associate.

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_Res_Des_Data_Size

Condividi tramite