다음을 통해 공유

AddMonitor 함수

  • 아티클

AddMonitor 함수는 로컬 포트 모니터를 설치하고 구성, 데이터 및 모니터 파일을 연결합니다.

구문

BOOL AddMonitor(
  _In_ LPTSTR pName,
  _In_ DWORD  Level,
  _In_ LPBYTE pMonitors
);

매개 변수

pName [in]

모니터를 설치해야 하는 서버의 이름을 지정하는 null로 끝나는 문자열에 대한 포인터입니다. 모니터의 로컬 설치만 지원하는 시스템의 경우 이 문자열은 NULL이어야 합니다.

수준 [in]

pMonitors가 가리키는 구조체의 버전입니다. 이 값은 2여야 합니다.

pMonitors [in]

MONITOR_INFO_2 구조체에 대한 포인터입니다. pMonitors 구조체의 pEnvironment 멤버가 NULL이면 대상(서버)이 아닌 호출자(클라이언트)의 현재 환경이 사용됩니다.

환경이 서버 환경과 일치하지 않으면 호출이 실패합니다. 즉, 서버 아키텍처에 대해 작성된 모니터만 추가할 수 있습니다.

반환 값

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

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

설명

참고

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

호출자에게 SeLoadDriverPrivilege가 있어야 합니다.

애플리케이션이 AddMonitor 함수를 호출하기 전에 모니터에 필요한 모든 파일을 SYSTEM32 디렉터리에 복사해야 합니다.

현재 설치된 포트 모니터를 확인하려면 EnumMonitors 함수를 호출합니다.

AddMonitor에서 추가한 모니터를 제거하려면 DeleteMonitor 함수를 호출합니다.

요구 사항

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

추가 정보

인쇄

인쇄 스풀러 API 함수

DeleteMonitor

EnumMonitors

MONITOR_INFO_2