CM_Get_First_Log_Conf-Funktion (cfgmgr32.h)
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.
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 |