CM_Get_Device_ID_Size_Ex-Funktion (cfgmgr32.h)
[Ab Windows 8 und Windows Server 2012 ist diese Funktion veraltet. Verwenden Sie stattdessen CM_Get_Device_ID_Size .]
Die CM_Get_Device_ID_Size_Ex-Funktion ruft die Puffergröße ab, die erforderlich ist, um ein Gerät instance-ID für ein Gerät instance auf einem lokalen oder Remotecomputer aufzunehmen.
Syntax
CMAPI CONFIGRET CM_Get_Device_ID_Size_Ex(
[out] PULONG pulLen,
[in] DEVINST dnDevInst,
[in] ULONG ulFlags,
[in, optional] HMACHINE hMachine
);
Parameter
[out] pulLen
Empfängt einen Wert, der die erforderliche Puffergröße in Zeichen darstellt.
[in] dnDevInst
Das vom Anrufer bereitgestellte Gerät instance Handle, das an den lokalen Computer gebunden ist.
[in] ulFlags
Nicht verwendet, muss null sein.
[in, optional] hMachine
Vom Aufrufer bereitgestelltes Computerhandle, an das das vom Aufrufer bereitgestellte Gerät instance Handle gebunden ist.
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
Die CM_Get_Device_ID_Size_Ex-Funktion sollte aufgerufen werden, um die für CM_Get_Device_ID_Ex erforderliche Puffergröße zu bestimmen.
Der Größenwert, der an der Position angegeben wird, auf die von pulLen verwiesen wird, ist kleiner als MAX_DEVICE_ID_LEN und enthält nicht die beendende NULL der Bezeichnerzeichenfolge. Wenn das angegebene Gerät instance nicht vorhanden ist, stellt die Funktion den Größenwert 0 bereit.
Informationen zu Geräte-instance-IDs finden Sie unter Geräteidentifikationszeichenfolgen.
Informationen zur Verwendung von Gerätehandles instance, die an einen lokalen oder Remotecomputer gebunden sind, finden Sie unter CM_Get_Child_Ex.
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 Versionen von Windows ausgeführt werden.
Anforderungen
| 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 |