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.

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

Weitere Informationen

CM_Get_Child

CM_Get_Device_ID

CM_Get_Device_ID_Size_Ex