CM_Get_First_Log_Conf-Funktion (cfgmgr32.h)

Artikel
08/22/2023

Die CM_Get_First_Log_Conf-Funktion ruft die erste logische Konfiguration eines angegebenen Konfigurationstyps ab, die einem angegebenen Gerät instance auf dem lokalen Computer zugeordnet ist.

Syntax

CMAPI CONFIGRET CM_Get_First_Log_Conf(
  [out, optional] PLOG_CONF plcLogConf,
  [in]            DEVINST   dnDevInst,
  [in]            ULONG     ulFlags
);

Parameter

[out, optional] plcLogConf

Adresse eines Speicherorts, an dem das Handle für eine logische Konfiguration empfangen werden soll, oder NULL. Weitere Informationen finden Sie im abschnitt "Hinweise" .

[in] dnDevInst

Vom Aufrufer bereitgestelltes Gerät instance Handle, das an den lokalen Computer gebunden ist.

[in] ulFlags

Vom Aufrufer bereitgestellter Flagwert, der den Typ der angeforderten logischen Konfiguration angibt. Eines der Flags in der folgenden Tabelle muss angegeben werden.

Konfigurationstypflags	Definitionen
BASIC_LOG_CONF	Der Aufrufer fordert grundlegende Konfigurationsinformationen an.
FILTERED_LOG_CONF	Der Aufrufer fordert gefilterte Konfigurationsinformationen an.
ALLOC_LOG_CONF	Der Aufrufer fordert zugeordnete Konfigurationsinformationen an.
BOOT_LOG_CONF	Der Aufrufer fordert Startkonfigurationsinformationen an.
FORCED_LOG_CONF	Der Aufrufer fordert erzwungene Konfigurationsinformationen an.
OVERRIDE_LOG_CONF	Der Aufrufer fordert Informationen zur Außerkraftsetzungskonfiguration an.

Rückgabewert

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

Hinweis Ab Windows 8 gibt CM_Get_First_Log_Conf bei Verwendung in einem Wow64-Szenario CR_CALL_NOT_IMPLEMENTED zurück. Um Informationen zu den Hardwareressourcen auf einem lokalen Computer anzufordern, muss eine architekturnative Version der Anwendung mithilfe der Hardwareressourcen-APIs implementiert werden. Beispiel: Eine AMD64-Anwendung für AMD64-Systeme.

Hinweise

Das Aufrufen von CM_Add_Empty_Log_Conf oder CM_Free_Log_Conf kann das Handle, das aus einem vorherigen Aufruf von CM_Get_First_Log_Conf abgerufen wurde, ungültig machen. Wenn Sie also logische Konfigurationen nach dem Aufruf CM_Add_Empty_Log_Conf oder CM_Free_Log_Conf abrufen möchten, muss Ihr Code CM_Get_First_Log_Conf erneut aufrufen und bei der ersten Konfiguration beginnen.

Das in plcLogConf empfangene Handle muss explizit durch Aufrufen CM_Free_Log_Conf_Handle freigegeben werden.

Wenn CM_Get_First_Log_Conf aufgerufen wird, wobei plcLogConf auf NULL festgelegt ist, wird kein Handle zurückgegeben. Auf diese Weise können Sie mithilfe des Rückgabe-status ermitteln, ob eine Konfiguration vorhanden ist, ohne dass das Handle anschließend freigegeben werden muss.

Informationen zur Verwendung von Geräte- instance Handles, die an den lokalen Computer gebunden sind, finden Sie unter CM_Get_Child.

Anforderungen

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