CM_Get_Device_ID_Size-Funktion (cfgmgr32.h)
Die CM_Get_Device_ID_Size-Funktion ruft die Puffergröße ab, die erforderlich ist, um ein Gerät instance-ID für ein Gerät instance auf dem lokalen Computer zu halten.
Hinweis
In Windows Vista und höheren Versionen von Windows verwendet das einheitliche Geräteeigenschaftenmodell den DEVPKEY_Device_InstanceIdEigenschaftenschlüssel, um den Gerätebezeichner instance darzustellen. Weitere Informationen finden Sie unter Abrufen eines Geräteinstanzbezeichners .
Syntax
CMAPI CONFIGRET CM_Get_Device_ID_Size(
[out] PULONG pulLen,
[in] DEVINST dnDevInst,
[in] ULONG ulFlags
);
Parameter
[out] pulLen
Empfängt einen Wert, der die erforderliche Puffergröße in Zeichen darstellt.
[in] dnDevInst
Vom Aufrufer bereitgestelltes Gerät instance Handle, das an den lokalen Computer gebunden ist.
[in] ulFlags
Nicht verwendet, muss null sein.
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
Die funktion CM_Get_Device_ID_Size sollte aufgerufen werden, um die für CM_Get_Device_ID erforderliche Puffergröße zu bestimmen.
Der Größenwert, der in der position angegeben wird, auf die von pulLen verwiesen wird, ist kleiner als MAX_DEVICE_ID_LEN und enthält nicht die endende NULL-Zeichenfolge der Bezeichnerzeichenfolge. Wenn das angegebene Gerät instance nicht vorhanden ist, gibt die Funktion den Größenwert 0 (null) an.
Informationen zu Geräte-instance-IDs finden Sie unter Geräteidentifikationszeichenfolgen.
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 | Universell |
| Header | cfgmgr32.h (include Cfgmgr32.h) |
| Bibliothek | Cfgmgr32.lib; OneCoreUAP.lib auf Windows 10 |
| DLL | CfgMgr32.dll |