SetupDiClassNameFromGuidExA-Funktion (setupapi.h)
Die SetupDiClassNameFromGuidEx--Funktion ruft den Klassennamen ab, der einer Klassen-GUID zugeordnet ist. Die Klasse kann auf einem lokalen oder Remotecomputer installiert werden.
Syntax
WINSETUPAPI BOOL SetupDiClassNameFromGuidExA(
[in] const GUID *ClassGuid,
[out] PSTR ClassName,
[in] DWORD ClassNameSize,
[out, optional] PDWORD RequiredSize,
[in, optional] PCSTR MachineName,
PVOID Reserved
);
Parameter
[in] ClassGuid
Die Klassen-GUID des abzurufenden Klassennamens.
[out] ClassName
Ein Zeiger auf einen Zeichenfolgenpuffer, der den NULL-beendeten Namen der Klasse für die angegebene GUID empfängt.
[in] ClassNameSize
Die Größe des ClassName- Puffers in Zeichen.
[out, optional] RequiredSize
Die Anzahl der Zeichen, die zum Speichern des Klassennamens erforderlich sind (einschließlich eines endenden NULL-Werts). RequiredSize- ist immer kleiner als MAX_CLASS_NAME_LEN.
[in, optional] MachineName
Ein Zeiger auf eine MIT NULL beendete Zeichenfolge, die den Namen eines Remotesystems enthält, auf dem die Klasse installiert ist. Dieser Parameter ist optional und kann NULL-werden. Wenn MachineName-NULL-ist, wird der lokale Systemname verwendet.
Vorsicht
Die Verwendung dieser Funktion für den Zugriff auf Remotecomputer wird ab Windows 8 und Windows Server 2012 nicht unterstützt, da diese Funktionalität entfernt wurde.
Reserved
Muss NULL-sein.
Rückgabewert
Die Funktion gibt TRUE- zurück, wenn sie erfolgreich ist. Andernfalls wird FALSE- zurückgegeben, und der protokollierte Fehler kann mit einem Aufruf von GetLastErrorabgerufen werden.
Bemerkungen
Anmerkung
Der Header setupapi.h definiert SetupDiClassNameFromGuidEx als Alias, der automatisch die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante 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 |