CM_Get_Device_ID_List_ExW-Funktion (cfgmgr32.h)

Artikel
02/26/2024

[Ab Windows 8 und Windows Server 2012 ist diese Funktion veraltet. Verwenden Sie stattdessen CM_Get_Device_ID_List .]

Die CM_Get_Device_ID_List_Ex-Funktion ruft eine Liste von Geräte-instance-IDs für die Geräteinstanzen auf einem lokalen oder einem Remotecomputer ab.

Syntax

CMAPI CONFIGRET CM_Get_Device_ID_List_ExW(
  [in, optional] PCWSTR   pszFilter,
  [out]          PZZWSTR  Buffer,
  [in]           ULONG    BufferLen,
  [in]           ULONG    ulFlags,
  [in, optional] HMACHINE hMachine
);

Parameter

[in, optional] pszFilter

Vom Aufrufer bereitgestellter Zeiger auf eine Zeichenfolge, die eine Teilmenge des Geräts des Computers instance Bezeichner oder NULL angibt. Siehe die folgende Beschreibung von ulFlags.

[out] Buffer

Adresse eines Puffers, um einen Satz von NULL-beendeten Geräte instance Bezeichnerzeichenfolgen zu empfangen. Das Ende der Gruppe wird durch einen zusätzlichen NULL-Wert beendet. Die erforderliche Puffergröße sollte durch Aufrufen von CM_Get_Device_ID_List_Size_Ex abgerufen werden.

[in] BufferLen

Vom Aufrufer angegebene Länge des puffers in Zeichen.

[in] ulFlags

Eines der optionalen, vom Aufrufer bereitgestellten Bitflags, die Suchfilter angeben. Wenn keine Flags angegeben sind, stellt die Funktion alle instance-Bezeichner für alle Geräteinstanzen bereit. Eine Liste der Bitflags-Flags finden Sie in der ulFlags-Beschreibung für CM_Get_Device_ID_List.

[in, optional] hMachine

Vom Anrufer bereitgestellter Maschinenhandle, der aus einem vorherigen Aufruf von CM_Connect_Machine abgerufen wurde.

Hinweis Die Verwendung dieser Funktion für den Zugriff auf Remotecomputer wird ab Windows 8 und Windows Server 2012 nicht unterstützt, da diese Funktionalität entfernt wurde.

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.

Hinweise

Informationen zu Geräte-instance-IDs finden Sie unter Geräteidentifikationszeichenfolgen.

Die Funktionalität für den Zugriff auf Remotecomputer wurde in Windows 8 und Windows Server 2012 und höheren Betriebssystemen entfernt, sodass Sie nicht auf Remotecomputer zugreifen können, wenn sie unter diesen Windows-Versionen ausgeführt werden.

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

Freigeben über