GetCommPorts 함수(winbase.h)

올바른 형식의 COM 포트를 포함하는 배열을 가져옵니다.

이 함수는 HKLM\Hardware\DeviceMap\SERIALCOMM 레지스트리 키에서 COM 포트 번호를 가져온 다음 호출자 제공 배열에 씁니다. 배열이 너무 작으면 함수는 필요한 크기를 가져옵니다.

참고 레지스트리 키에 새 항목이 추가되면 API 호출 간에 필요한 크기가 변경됩니다.

구문

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

[out] lpPortNumbers

포트 번호에 대한 배열입니다.

[in] uPortNumbersCount

lpPortNumbers 매개 변수의 배열 길이입니다.

[out] puPortNumbersFound

lpPortNumbers에 기록된 포트 번호의 수 또는 포트 번호에 필요한 배열의 길이입니다.

반환 코드	설명
ERROR_SUCCESS	호출이 성공했습니다. lpPortNumbers 배열은 결과에 충분히 큼.
ERROR_MORE_DATA	lpPortNumbers 배열이 너무 작아서 사용 가능한 모든 포트 번호를 포함할 수 없습니다.
ERROR_FILE_NOT_FOUND	사용할 수 있는 통신 포트가 없습니다.