Freigeben über

GetCommPorts-Funktion (winbase.h)

  • Artikel

Ruft ein Array ab, das die wohlgeformten COM-Ports enthält.

Diese Funktion ruft die COM-Portnummern aus dem Registrierungsschlüssel HKLM\Hardware\DeviceMap\SERIALCOMM ab und schreibt sie dann in ein vom Aufrufer bereitgestelltes Array. Wenn das Array zu klein ist, erhält die Funktion die erforderliche Größe.

Hinweis Wenn dem Registrierungsschlüssel neue Einträge hinzugefügt werden, kann sich die erforderliche Größe zwischen API-Aufrufen ändern.
 

Syntax

ULONG GetCommPorts(
  [out] PULONG lpPortNumbers,
  [in]  ULONG  uPortNumbersCount,
  [out] PULONG puPortNumbersFound
);

Parameter

[out] lpPortNumbers

Ein Array für die Portnummern.

[in] uPortNumbersCount

Die Länge des Arrays im lpPortNumbers-Parameter .

[out] puPortNumbersFound

Die Anzahl der Portnummern, die in die lpPortNumbers geschrieben werden, oder die Länge des Arrays, das für die Portnummern erforderlich ist.

Rückgabewert

Rückgabecode Beschreibung
ERROR_SUCCESS
 Der Aufruf war erfolgreich. Das LpPortNumbers-Array war groß genug für das Ergebnis.
ERROR_MORE_DATA
 Das LpPortNumbers-Array war zu klein, um alle verfügbaren Portnummern zu enthalten.
ERROR_FILE_NOT_FOUND
 Es sind keine Comm-Ports verfügbar.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows 10, Version 1803 [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server) Windows Server, Version 1709 [Desktop-Apps | UWP-Apps]
Zielplattform Windows
Kopfzeile winbase.h (Windows.h einschließen)
Bibliothek OneCore.lib
DLL KernelBase.dll