CM_Get_Res_Des_Data-Funktion (cfgmgr32.h)

  • Artikel

Die CM_Get_Res_Des_Data-Funktion ruft die Informationen ab, die in einem Ressourcendeskriptor auf dem lokalen Computer gespeichert sind.

Syntax

CMAPI CONFIGRET CM_Get_Res_Des_Data(
  [in]  RES_DES rdResDes,
  [out] PVOID   Buffer,
  [in]  ULONG   BufferLen,
  [in]  ULONG   ulFlags
);

Parameter

[in] rdResDes

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

[out] Buffer

Adresse eines Puffers, um den Inhalt eines Ressourcendeskriptors zu empfangen. Die erforderliche Puffergröße sollte durch Aufrufen von CM_Get_Res_Des_Data_Size abgerufen werden.

[in] BufferLen

Vom Aufrufer bereitgestellte Länge des Puffers, der von Buffer angegeben wird.

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

Die im Puffer zurückgegebenen Informationen werden als eine der Ressourcentypstrukturen formatiert, die in der Beschreibung von CM_Add_Res_Des aufgeführt sind, basierend auf dem Ressourcentyp, der angegeben wurde, als CM_Get_Next_Res_Des aufgerufen wurde, um das Ressourcendeskriptorhandle abzurufen.

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_Ex