SetupDiGetHwProfileFriendlyNameExW-Funktion (setupapi.h)
Die SetupDiGetHwProfileFriendlyNameEx Funktion ruft den Anzeigenamen ab, der einer Hardwareprofil-ID auf einem lokalen oder Remotecomputer zugeordnet ist.
Syntax
WINSETUPAPI BOOL SetupDiGetHwProfileFriendlyNameExW(
[in] DWORD HwProfile,
[out] PWSTR FriendlyName,
[in] DWORD FriendlyNameSize,
[out, optional] PDWORD RequiredSize,
[in, optional] PCWSTR MachineName,
PVOID Reserved
);
Parameter
[in] HwProfile
Stellt die Hardwareprofil-ID bereit, die dem anzeigenamen zugeordnet ist, der abgerufen werden soll. Wenn dieser Parameter 0 ist, wird der Anzeigename für das aktuelle Hardwareprofil abgerufen.
[out] FriendlyName
Ein Zeiger auf einen Zeichenpuffer, um den Anzeigenamen zu erhalten.
[in] FriendlyNameSize
Die Größe des FriendlyName- Puffers in Zeichen.
[out, optional] RequiredSize
Ein Zeiger auf eine Variable, um die Anzahl der Zeichen zu erhalten, die zum Speichern des Anzeigenamens erforderlich sind (einschließlich eines NULL-Terminators). Dieser Parameter ist optional und kann NULL-werden.
[in, optional] MachineName
Ein Zeiger auf NULL beendete Zeichenfolge, die den Namen eines Remotecomputers enthält, auf dem sich die Hardwareprofil-ID befindet. Dieser Parameter ist optional und kann NULL-werden. Wenn MachineName-NULL-ist, befindet sich die Hardwareprofil-ID auf dem lokalen Computer.
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 abgerufen werden, indem ein Aufruf an GetLastError-ausgeführt wird.
Bemerkungen
Anmerkung
Der header setupapi.h definiert SetupDiGetHwProfileFriendlyNameEx 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 |