CM_Get_Device_IDW-Funktion (cfgmgr32.h)
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 |