CM_Get_Device_IDW-Funktion (cfgmgr32.h)

Artikel
02/26/2024

Die CM_Get_Device_ID-Funktion ruft das Gerät instance-ID für ein angegebenes Gerät ab, das auf dem lokalen Computer instance.

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_IDW(
  [in]  DEVINST dnDevInst,
  [out] PWSTR   Buffer,
  [in]  ULONG   BufferLen,
  [in]  ULONG   ulFlags
);

Parameter

[in] dnDevInst

Das vom Anrufer bereitgestellte Gerät instance Handle, das an den lokalen Computer gebunden ist.

[out] Buffer

Adresse eines Puffers zum Empfangen eines Geräts instance ID-Zeichenfolge. Die erforderliche Puffergröße kann abgerufen werden, indem sie CM_Get_Device_ID_Size aufrufen und dann den empfangenen Wert erhöhen, um Platz für die beendende NULL-Zeichenfolge zuzulassen.

[in] BufferLen

Vom Aufrufer angegebene Länge des puffers in Zeichen.

[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 CR_-Präfix-Fehlercodes zurückgegeben, die in Cfgmgr32.h definiert sind.

Hinweise

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

Informationen zu Geräte-instance-IDs finden Sie unter Geräteidentifikationszeichenfolgen.

Informationen zur Verwendung von Gerätehandles instance, 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 (einschließlich Cfgmgr32.h)
Bibliothek	Cfgmgr32.lib

Weitere Informationen

CM_Get_Child

CM_Get_Device_ID_Ex

Freigeben über