ComDBClaimNextFreePort 함수(msports.h)

ComDBClaimNextFreePort 는 아직 사용되지 않는 가장 낮은 COM 포트 번호를 반환합니다.

구문

LONG ComDBClaimNextFreePort(
  [in]  HCOMDB  HComDB,
  [out] LPDWORD ComNumber
);

[in] HComDB

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

[out] ComNumber

루틴이 호출자에게 반환하는 COM 포트 번호에 대한 포인터입니다. 이 포인터는 NULL이 아닌 포인터여야 합니다. 포트 번호는 1에서 COMDB_MAX_PORTS_ARBITRATED 범위의 정수입니다.

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

반환 코드	설명
ERROR_SUCCESS	루틴이 COM 포트 번호를 성공적으로 반환했습니다.
ERROR_CANTWRITE	루틴이 데이터베이스에 쓸 수 없습니다.
ERROR_INVALID_PARAMETER	지정된 COM 포트 데이터베이스 핸들이 잘못되었습니다.
ERROR_NO_LOG_SPACE	데이터베이스는 더 이상 포트 번호를 중재할 수 없습니다.
ERROR_NOT_CONNECTED	루틴이 데이터베이스에 액세스할 수 없습니다. 확장 오류 정보를 가져오려면 GetLastError를 호출합니다.
ERROR_Xxx	내부 오류가 발생했습니다. GetLastError 를 호출하여 확장된 오류 정보를 가져옵니다.

COM 포트 데이터베이스에서 COM 포트 번호를 클레임하면 포트 번호가 "사용 중"으로 기록됩니다. 데이터베이스에는 포트 번호를 주장하는 호출자 또는 디바이스에 대한 정보가 포함되어 있지 않습니다.

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