AddPort 함수
AddPort 함수는 지원되는 포트 목록에 포트 이름을 추가합니다. AddPort 함수는 포트 모니터에서 내보냅니다.
구문
BOOL AddPort(
_In_ LPTSTR pName,
_In_ HWND hWnd,
_In_ LPTSTR pMonitorName
);
매개 변수
-
pName [in]
-
포트가 연결된 서버의 이름을 지정하는 0으로 끝나는 문자열에 대한 포인터입니다. 이 매개 변수가 NULL이면 포트가 로컬입니다.
-
hWnd [in]
-
AddPort 대화 상자의 부모 창에 대한 핸들입니다.
-
pMonitorName [in]
-
포트와 연결된 모니터를 지정하는 0으로 끝나는 문자열에 대한 포인터입니다.
반환 값
함수가 성공하면 반환 값은 0이 아닌 값입니다.
함수가 실패하면 반환 값은 0입니다.
설명
참고
이는 차단 또는 동기 함수이며 즉시 반환되지 않을 수 있습니다. 이 함수가 반환되는 빈도는 애플리케이션을 작성할 때 예측하기 어려운 네트워크 상태, 인쇄 서버 구성 및 프린터 드라이버 구현 요소와 같은 런타임 요인에 따라 달라집니다. 사용자 인터페이스와의 상호 작용을 관리하는 스레드에서 이 함수를 호출하면 애플리케이션이 응답하지 않는 것처럼 보일 수 있습니다.
AddPort 함수는 네트워크를 검색하여 기존 포트를 찾고 사용자에 대한 대화 상자를 표시합니다. AddPort 함수는 중복된 이름이 없는지 확인하기 위해 EnumPorts를 호출하여 사용자가 입력한 포트 이름의 유효성을 검사해야 합니다.
AddPort 함수의 호출자는 포트가 연결된 서버에 대한 SERVER_ACCESS_ADMINISTER 액세스 권한이 있어야 합니다.
대화 상자를 표시하지 않고 포트를 추가하려면 AddPort 대신 XcvData 함수를 호출합니다. XcvData에 대한 자세한 내용은 Microsoft Windows DDK(드라이버 개발 키트)를 참조하세요.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 |
Windows 2000 Professional[데스크톱 앱만] |
| 지원되는 최소 서버 |
Windows 2000 Server[데스크톱 앱만] |
| 헤더 |
|
| 라이브러리 |
|
| DLL |
|
| 유니코드 및 ANSI 이름 |
AddPortW (유니코드) 및 AddPortA (ANSI) |