다음을 통해 공유

ComDBClaimPort 함수(msports.h)

  • 아티클

ComDBClaimPort 는 사용되지 않는 COM 포트 번호를 COM 포트 데이터베이스에서 "사용 중"으로 기록합니다.

구문

LONG ComDBClaimPort(
  [in]            HCOMDB HComDB,
  [in]            DWORD  ComNumber,
  [in]            BOOL   ForceClaim,
  [out, optional] PBOOL  Forced
);

매개 변수

[in] HComDB

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

[in] ComNumber

호출자가 클레임하려고 시도하는 COM 포트 번호를 지정합니다. 포트 번호는 1에서 COMDB_MAX_PORTS_ARBITRATED 범위가 될 수 있는 정수입니다.

[in] ForceClaim

이 속성은 내부 전용으로 예약되어 있으므로

[out, optional] Forced

이 속성은 내부 전용으로 예약되어 있으므로

반환 값

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

반환 코드 설명
ERROR_SUCCESS
 COM 포트 번호가 사용 중이 아니고 이제 "사용 중"으로 기록됩니다.
ERROR_CANTWRITE
 루틴을 데이터베이스에 쓸 수 없습니다.
ERROR_INVALID_PARAMETER
 다음 중 하나는 true입니다. COM 포트 데이터베이스에 대해 지정된 핸들이 잘못되었습니다. 지정된 포트 번호가 COMDB_MAX_PORTS_ARBITRATED 초과합니다.
ERROR_NOT_CONNECTED
 루틴이 데이터베이스에 액세스할 수 없습니다. 확장 오류 정보를 가져오려면 GetLastError를 호출합니다.
ERROR_SHARING_VIOLATION
 지정된 포트 번호가 이미 사용 중입니다.
ERROR_Xxx
 내부 오류가 발생했습니다. GetLastError 를 호출하여 확장된 오류 정보를 가져옵니다.

설명

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

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

자세한 내용은 COM 포트 번호 가져오기 및 해제를 참조하세요.

요구 사항

요구 사항 값
대상 플랫폼 데스크톱
머리글 msports.h(Msports.h 포함)
라이브러리 Msports.lib
DLL Msports.dll

추가 정보

ComDBClaimNextFreePort

ComDBReleasePort