SetPort 함수

  • 아티클

SetPort 함수는 프린터 포트와 연결된 상태 설정합니다.

구문

BOOL SetPort(
  _In_ LPTSTR pName,
  _In_ LPTSTR pPortName,
  _In_ DWORD  dwLevel,
  _In_ LPBYTE pPortInfo
);

매개 변수

pName [in]

포트가 연결된 프린터 서버의 이름을 지정하는 0으로 끝나는 문자열에 대한 포인터입니다. 포트가 로컬 컴퓨터에 있는 경우 이 매개 변수를 NULL 로 설정합니다.

pPortName [in]

프린터 포트의 이름을 지정하는 0으로 끝나는 문자열에 대한 포인터입니다.

dwLevel [in]

pPortInfo 매개 변수가 가리키는 구조체의 형식을 지정합니다.

이 값은 PORT_INFO_3 데이터 구조에 해당하는 3이어야 합니다.

pPortInfo [in]

설정할 포트 상태 정보가 포함된 PORT_INFO_3 구조체에 대한 포인터입니다.

반환 값

함수가 성공하면 반환 값은 0이 아닌 값입니다.

함수가 실패하면 반환 값은 0입니다.

설명

참고

이는 차단 또는 동기 함수이며 즉시 반환되지 않을 수 있습니다. 이 함수가 얼마나 빨리 반환되는지는 네트워크 상태, 인쇄 서버 구성 및 애플리케이션을 작성할 때 예측하기 어려운 프린터 드라이버 구현 요소와 같은 런타임 요인에 따라 달라집니다. 사용자 인터페이스와의 상호 작용을 관리하는 스레드에서 이 함수를 호출하면 애플리케이션이 응답하지 않는 것처럼 보일 수 있습니다.

SetPort 함수의 호출자가 관리자 권한으로 실행되어야 합니다. 또한 호출자가 포트 모니터 또는 언어 모니터인 경우 SetPort를 호출하기 전에 RevertToSelf를 호출하여 가장을 중단해야 합니다.

SetPort를 호출하는 모든 프로그램에는 포트가 연결된 서버에 대한 SERVER_ACCESS_ADMINISTER 액세스 권한이 있어야 합니다.

심각도 값이 PORT_STATUS_TYPE_ERROR 프린터 포트 상태 값을 설정하면 인쇄 스풀러가 포트로 작업 보내기를 중지합니다. SetPort에 대한 다른 호출을 통해 포트 상태 지워지면 인쇄 스풀러가 포트로 작업 보내기를 다시 시작합니다.

요구 사항

요구 사항 값
지원되는 최소 클라이언트
 Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버
 Windows 2000 Server[데스크톱 앱만]
헤더
Winspool.h(Windows.h 포함)
라이브러리
Winspool.lib
DLL
Winspool.drv
유니코드 및 ANSI 이름
 SetPortW (유니코드) 및 SetPortA (ANSI)

추가 정보

인쇄

인쇄 스풀러 API 함수

PORT_INFO_3