CM_Get_Device_IDA Funktion (cfgmgr32.h)

Die CM_Get_Device_ID-Funktion ruft die Geräteinstanz-ID für eine angegebene Geräteinstanz auf dem lokalen Computer ab.

Syntax

CMAPI CONFIGRET CM_Get_Device_IDA(
  [in]  DEVINST dnDevInst,
  [out] PSTR    Buffer,
  [in]  ULONG   BufferLen,
  [in]  ULONG   ulFlags
);

Parameter

[in] dnDevInst

Vom Aufrufer bereitgestelltes Geräteinstanzhandle, das an den lokalen Computer gebunden ist.

[out] Buffer

Adresse eines Puffers zum Empfangen einer Geräteinstanz-ID-Zeichenfolge. Die erforderliche Puffergröße kann durch Aufrufen von CM_Get_Device_ID_Sizeabgerufen werden. Anschließend wird der empfangene Wert erhöht, um platz für das Beenden der Zeichenfolge NULL-zuzulassen.

[in] BufferLen

Vom Aufrufer bereitgestellte Länge des durch Bufferangegebenen Puffer in Zeichen.

[in] ulFlags

Nicht verwendet, darf null sein.

Rückgabewert

Wenn der Vorgang erfolgreich ist, gibt die Funktion CR_SUCCESS zurück. Andernfalls wird eine der CR_-präfixierten Fehlercodes zurückgegeben, die in Cfgmgr32.hdefiniert sind.

Bemerkungen

Die Funktion fügt einen NULL-Terminator an die angegebene Geräteinstanz-ID-Zeichenfolge an, es sei denn, der Puffer ist zu klein, um die Zeichenfolge aufzunehmen. In diesem Fall stellt die Funktion so viel der Bezeichnerzeichenfolge bereit, wie sie in den Puffer passt, und gibt dann CR_BUFFER_SMALL zurück.

Informationen zu Geräteinstanz-IDs finden Sie unter Device Identification Strings.

Informationen zur Verwendung von Geräteinstanzhandles, die an den lokalen Computer gebunden sind, finden Sie unter CM_Get_Child.

Anforderungen

Siehe auch

CM_Get_Child
CM_Get_Device_ID_Ex