SetupDiGetDeviceInstanceIdA-Funktion (setupapi.h)

Die SetupDiGetDeviceInstanceId Funktion ruft die Geräteinstanz-ID ab, die einem Geräteinformationselement zugeordnet ist.

Anmerkung

In Windows Vista und höheren Versionen von Windows verwendet das einheitliche Geräteeigenschaftenmodell den DEVPKEY_Device_InstanceIdEigenschaftenschlüssel, um den Geräteinstanzbezeichner darzustellen. Weitere Informationen finden Sie unter Abrufen eines Geräteinstanzbezeichners.

Syntax

WINSETUPAPI BOOL SetupDiGetDeviceInstanceIdA(
  [in]            HDEVINFO         DeviceInfoSet,
  [in]            PSP_DEVINFO_DATA DeviceInfoData,
  [out, optional] PSTR             DeviceInstanceId,
  [in]            DWORD            DeviceInstanceIdSize,
  [out, optional] PDWORD           RequiredSize
);

Parameter

[in] DeviceInfoSet

Ein Handle zum Geräteinformationssatz, das das Geräteinformationselement enthält, das das Gerät darstellt, für das eine Geräteinstanz-ID abgerufen werden soll.

[in] DeviceInfoData

Ein Zeiger auf eine SP_DEVINFO_DATA Struktur, die das Geräteinformationselement in DeviceInfoSet-angibt.

[out, optional] DeviceInstanceId

Ein Zeiger auf den Zeichenpuffer, der die NULL-beendete Geräteinstanz-ID für das angegebene Geräteinformationselement empfängt. Informationen zu Geräteinstanz-IDs finden Sie unter Device Identification Strings.

[in] DeviceInstanceIdSize

Die Größe des DeviceInstanceId- Puffers in Zeichen.

[out, optional] RequiredSize

Ein Zeiger auf die Variable, die die Anzahl der Zeichen empfängt, die zum Speichern der Geräteinstanz-ID erforderlich sind.

Rückgabewert

Die Funktion gibt TRUE- zurück, wenn sie erfolgreich ist. Andernfalls wird FALSE- zurückgegeben, und der protokollierte Fehler kann abgerufen werden, indem ein Aufruf an GetLastError-ausgeführt wird.

Bemerkungen

Anmerkung

Der Header setupapi.h definiert SetupDiGetDeviceInstanceId als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Verfügbar in Microsoft Windows 2000 und höheren Versionen von Windows.
Zielplattform-	Desktop
Header-	setupapi.h (include Setupapi.h)
Library	Setupapi.lib

Siehe auch

SP_DEVINFO_DATA

SetupDiCreateDevRegKey-

SetupDiCreateDeviceInfo-

SetupDiOpenDevRegKey

SetupDiOpenDeviceInfo