CM_Get_Device_ID_List_ExA-Funktion (cfgmgr32.h)

[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 der Geräte-instance-IDs für die Geräteinstanzen auf einem lokalen computer oder einem Remotecomputer ab.

Syntax

CMAPI CONFIGRET CM_Get_Device_ID_List_ExA(
  [in, optional] PCSTR    pszFilter,
  [out]          PZZSTR   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. Weitere Informationen finden Sie in der folgenden Beschreibung von ulFlags.

[out] Buffer

Adresse eines Puffers, der eine Reihe von NULL-beendeten Geräte instance-Bezeichnerzeichenfolgen empfangen soll. Das Ende des Satzes 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 bereitgestellte Länge des durch Puffer angegebenen Puffers in Zeichen.

[in] ulFlags

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

[in, optional] hMachine

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

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

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 späteren Betriebssystemen entfernt, sodass Sie nicht auf Remotecomputer zugreifen können, wenn Sie unter diesen Versionen von Windows ausgeführt werden.

Anforderungen