CM_Get_Res_Des_Data_Size-Funktion (cfgmgr32.h)

  • Artikel

Die CM_Get_Res_Des_Data_Size-Funktion ruft die Puffergröße ab, die erforderlich ist, um die in einem angegebenen Ressourcendeskriptor enthaltenen Informationen auf dem lokalen Computer zu enthalten.

Syntax

CMAPI CONFIGRET CM_Get_Res_Des_Data_Size(
  [out] PULONG  pulSize,
  [in]  RES_DES rdResDes,
  [in]  ULONG   ulFlags
);

Parameter

[out] pulSize

Vom Aufrufer angegebene Adresse eines Speicherorts, um die erforderliche Puffergröße zu erhalten.

[in] rdResDes

Vom Aufrufer bereitgestelltes Handle für einen Ressourcendeskriptor, der durch einen vorherigen Aufruf von CM_Get_Next_Res_Des abgerufen wurde.

[in] ulFlags

Nicht verwendet, muss null sein.

Rückgabewert

Wenn der Vorgang erfolgreich ist, gibt die Funktion CR_SUCCESS zurück. Andernfalls wird einer der CR_-Präfix-Fehlercodes zurückgegeben, die in Cfgmgr32.h definiert sind.

Hinweis Ab Windows 8 gibt CM_Get_Res_Des_Data_Size bei Verwendung in einem Wow64-Szenario CR_CALL_NOT_IMPLEMENTED zurück. Zum Anfordern von Informationen zu den Hardwareressourcen auf einem lokalen Computer ist es erforderlich, eine native Version der Anwendung mithilfe der Hardwareressourcen-APIs zu implementieren. Beispiel: Eine AMD64-Anwendung für AMD64-Systeme.
 

Hinweise

Der zurückgegebene Größenwert stellt die Größe der entsprechenden Ressourcenstruktur dar (siehe CM_Add_Res_Des). Wenn sich der Ressourcendeskriptor in einer Ressourcenbedarfsliste befindet, umfasst die zurückgegebene Größe sowohl die Größe der Ressourcenstruktur als auch den für zugeordnete Bereichsarrays zugewiesenen Speicherplatz.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Verfügbar in Microsoft Windows 2000 und höheren Versionen von Windows.
Zielplattform Desktop
Kopfzeile cfgmgr32.h (einschließlich Cfgmgr32.h)
Bibliothek Cfgmgr32.lib
DLL Cfgmgr32.dll

Weitere Informationen

CM_Get_Res_Des_Data_Size_Ex