ComDBReleasePort 함수(msports.h)

ComDBReleasePort 는 COM 포트 데이터베이스에서 COM 포트 번호를 해제합니다.

구문

LONG ComDBReleasePort(
  [in] HCOMDB HComDB,
  [in] DWORD  ComNumber
);

[in] HComDB

ComDBOpen에서 반환된 COM 포트 데이터베이스에 대한 핸들입니다.

[in] ComNumber

해제할 COM 포트 번호를 지정합니다. 포트 번호는 1에서 COMDB_MAX_PORTS_ARBITRATED 범위의 정수입니다.

ComDBReleasePort는 다음 상태 값 중 하나를 반환합니다.

반환 코드	설명
ERROR_SUCCESS	COM 포트 번호가 릴리스되었습니다.
ERROR_CANTWRITE	루틴이 데이터베이스에 쓸 수 없습니다.
ERROR_INVALID_PARAMETER	다음 중 하나는 true입니다. COM 포트 데이터베이스에 대해 지정된 핸들이 잘못되었습니다. 지정된 포트 번호가 COM 포트 데이터베이스에 없습니다.
ERROR_NOT_CONNECTED	루틴이 데이터베이스에 액세스할 수 없습니다. 확장 오류 정보를 가져오려면 GetLastError를 호출합니다.

COM 포트 번호를 해제하면 포트 번호를 "사용되지 않음"으로 기록합니다.

ComDBReleasePort 는 사용자 모드에서 실행됩니다.