Win32_BaseService 클래스

  • 아티클

Win32_BaseService 추상 WMI 클래스는 Service Control Manager에서 유지 관리하는 레지스트리 데이터베이스에 설치된 실행 개체를 나타냅니다. 서비스와 연결된 실행 파일은 부팅 프로그램 또는 시스템에서 부팅 시 시작할 수 있습니다. Service Control Manager에서 주문형으로 시작할 수도 있습니다. 특정 사용자가 소유하지 않고 컴퓨터 시스템에서 지원하는 일부 기능에 대한 인터페이스를 제공하는 모든 서비스 또는 프로세스는 이 클래스의 하위 항목(또는 멤버)입니다.

예: Windows Server를 실행하는 컴퓨터 시스템의 DHCP(동적 호스트 구성 프로토콜) 클라이언트 서비스입니다.

다음 구문은 MOF(Managed Object Format) 코드를 단순화한 것으로 상속된 속성이 모두 포함되어 있습니다. 속성은 MOF 순서가 아닌 알파벳순으로 나열됩니다.

구문

[SupportsCreate, CreateBy("Create"), SupportsDelete, DeleteBy("DeleteInstance"), Abstract, Provider("CIMWin32"), UUID("{8502C4C4-5FBB-11D2-AAC1-006008C78BC7}"), DisplayName("System Drivers and Services"), AMENDMENT]
class Win32_BaseService : CIM_Service
{
  boolean  AcceptPause;
  boolean  AcceptStop;
  string   Caption;
  string   CreationClassName;
  string   Description;
  boolean  DesktopInteract;
  string   DisplayName;
  string   ErrorControl;
  uint32   ExitCode;
  datetime InstallDate;
  string   Name;
  string   PathName;
  uint32   ServiceSpecificExitCode;
  string   ServiceType;
  boolean  Started;
  string   StartMode;
  string   StartName;
  string   State;
  string   Status;
  string   SystemCreationClassName;
  string   SystemName;
  uint32   TagId;
};

멤버

Win32_BaseService 클래스에는 다음과 같은 유형의 멤버가 있습니다.

메서드

Win32_BaseService 클래스에는 이러한 메서드가 있습니다.

메서드 설명
변경 서비스를 수정합니다.
ChangeStartMode 서비스의 시작 모드를 수정합니다.
만들기 새 서비스를 만듭니다.
삭제 기존 서비스를 삭제합니다.
InterrogateService 서비스가 해당 상태를 서비스 관리자로 업데이트하도록 요청합니다.
PauseService 서비스를 일지 중지된 상태로 지정합니다.
ResumeService 서비스를 재개된 상태로 지정합니다.
StartService 서비스를 시작 상태로 전환하려고 시도합니다.
StopService 서비스를 중지된 상태로 배치하는 클래스 메서드입니다.
UserControlService 사용자 정의 제어 코드를 서비스에 보내려고 시도합니다.

속성

Win32_BaseService 클래스에는 이러한 속성이 있습니다.

AcceptPause

데이터 형식: boolean

액세스 형식: 읽기 전용

한정자: MappingStrings ("Win32API| 서비스 구조| SERVICE_STATUS|dwControlsAccepted| SERVICE_ACCEPT_PAUSE_CONTINUE"), DisplayName ("서비스가 일시 중지 허용")

서비스를 일시 중지할 수 있습니다.

AcceptStop

데이터 형식: boolean

액세스 형식: 읽기 전용

한정자: MappingStrings ("Win32API| 서비스 구조| SERVICE_STATUS|dwControlsAccepted| SERVICE_ACCEPT_STOP"), DisplayName ("서비스가 중지를 수락함")

서비스를 중지할 수 있습니다.

캡션

데이터 형식: string

액세스 형식: 읽기 전용

한정자: MaxLen (64), DisplayName ("Caption")

개체에 대한 간단한 설명입니다.

이 속성은 CIM_ManagedSystemElement 상속됩니다.

CreationClassName

데이터 형식: 문자열

액세스 형식: 읽기 전용

한정자: CIM_Key, DisplayName ("클래스 이름")

instance 만드는 데 사용되는 상속 체인에 표시할 첫 번째 구체적인 클래스의 이름입니다. 클래스의 다른 키 속성과 함께 사용할 경우 속성을 사용하면 이 클래스의 모든 인스턴스와 해당 서브클래스를 고유하게 식별할 수 있습니다.

이 속성은 CIM_Service 상속됩니다.

설명

데이터 형식: 문자열

액세스 형식: 읽기 전용

한정자: DisplayName ("Description")

개체에 대한 설명입니다.

이 속성은 CIM_ManagedSystemElement 상속됩니다.

DesktopInteract

데이터 형식: boolean

액세스 형식: 읽기 전용

한정자: MappingStrings ("Win32API| 서비스 구조| QUERY_SERVICE_CONFIG|dwServiceType| SERVICE_INTERACTIVE_PROCESS"), DisplayName ("데스크톱과 상호 작용")

서비스는 데스크톱에서 창을 만들거나 통신할 수 있습니다.

표시 이름

데이터 형식: 문자열

액세스 형식: 읽기 전용

한정자: MappingStrings ("Win32API| 서비스 구조| QUERY_SERVICE_CONFIG|lpDisplayName"), DisplayName ("표시 이름")

서비스의 표시 이름입니다. 이 문자열의 최대 길이는 256자입니다. 이름은 서비스 제어 관리자에서 대/소문자를 유지합니다. DisplayName 비교는 항상 대/소문자를 구분하지 않습니다.

제약 조건: Name 속성과 동일한 값을 허용합니다.

예: "Atdisk"

ErrorControl

데이터 형식: 문자열

액세스 형식: 읽기 전용

한정자: MappingStrings ("Win32API| 서비스 구조| QUERY_SERVICE_CONFIG|dwErrorControl"), DisplayName ("시작 실패 심각도")

오류의 심각도 서비스가 시작되지 않습니다. 값은 오류가 발생하는 경우 시작 프로그램에서 수행한 작업을 나타냅니다. 모든 오류는 컴퓨터 시스템에 기록됩니다.

무시 ("무시")

사용자에게 오류를 알리지 않습니다.

Normal ("Normal")

사용자에게 오류를 알립니다.

심각 ("심각")

마지막으로 알려진 양수 구성으로 시스템이 다시 시작되었습니다.

Critical ("Critical")

올바른 구성으로 시스템을 다시 시작합니다.

알 수 없음 ("알 수 없음")

수행된 작업은 지정되지 않습니다.

ExitCode

데이터 형식: uint32

액세스 형식: 읽기 전용

한정자: MappingStrings ("Win32API| 서비스 구조| SERVICE_STATUS|dwWin32ExitCode"), DisplayName ("종료 코드")

서비스를 시작하거나 중지할 때 발생하는 문제를 정의합니다. 오류가 이 클래스가 나타내는 서비스에 고유한 것이고 ServiceSpecificExitCode 속성에서 오류 정보를 사용할 수 있으면 이 속성은 ERROR_SERVICE_SPECIFIC_ERROR (1066)로 설정됩니다. 서비스는 이 값을 실행할 때 NO_ERROR 설정하며 정상 종료 시 다시 설정합니다.

InstallDate

데이터 형식: datetime

액세스 형식: 읽기 전용

한정자: MappingStrings ("MIF. DMTF| ComponentID|001.5"), DisplayName ("설치 날짜")

개체가 설치되었습니다. 이 속성은 개체가 설치되었음을 나타내는 값이 필요하지 않습니다.

이 속성은 CIM_ManagedSystemElement 상속됩니다.

이름

데이터 형식: 문자열

액세스 형식: 읽기 전용

한정자: Key

관리되는 기능을 나타내는 서비스의 고유 식별자입니다. 이 기능은 개체의 Description 속성에 자세히 설명되어 있습니다.

이 속성은 CIM_ManagedSystemElement 상속됩니다.

PathName

데이터 형식: 문자열

액세스 형식: 읽기 전용

한정자: MappingStrings ("Win32API| 서비스 구조| QUERY_SERVICE_CONFIG|lpBinaryPathName"), DisplayName ("파일 경로 이름")

서비스를 구현하는 서비스 이진 파일에 대한 정규화된 경로입니다.

예: "\SystemRoot\System32\drivers\afd.sys"

ServiceSpecificExitCode

데이터 형식: uint32

액세스 형식: 읽기 전용

한정자: MappingStrings ("Win32API| 서비스 구조| SERVICE_STATUS|dwServiceSpecificExitCode"), DisplayName ("서버별 종료 코드")

서비스가 시작 또는 중지되는 동안 발생하는 오류에 대한 서비스별 오류 코드입니다. 종료 코드는 이 클래스가 나타내는 서비스에 의해 정의됩니다. 이 값은 ExitCodeproperty 값이 ERROR_SERVICE_SPECIFIC_ERROR (1066)일 때만 설정됩니다.

ServiceType

데이터 형식: 문자열

액세스 형식: 읽기 전용

한정자: MappingStrings ("Win32API| 서비스 구조| QUERY_SERVICE_CONFIG|dwServiceType"), DisplayName ("서비스 유형")

호출 프로세스에 제공되는 서비스입니다.

커널 드라이버 ("커널 드라이버")

파일 시스템 드라이버 ("파일 시스템 드라이버")

어댑터 ("어댑터")

Recognizer 드라이버 ("Recognizer Driver")

자체 프로세스 ("자체 프로세스")

프로세스 공유 ("프로세스 공유")

대화형 프로세스 ("대화형 프로세스")

시작됨

데이터 형식: boolean

액세스 형식: 읽기 전용

한정자: DisplayName ("Started")

서비스가 시작되었습니다.

이 속성은 CIM_Service 상속됩니다.

StartMode

데이터 형식: 문자열

액세스 형식: 읽기 전용

한정자: 재정의 ("StartMode"), DisplayName ("시작 모드")

Windows 기본 서비스의 시작 모드입니다.

이 속성은 CIM_Service 상속됩니다.

부팅 ("부팅")

운영 체제 로더에서 시작한 디바이스 드라이버입니다(드라이버 서비스에만 유효).

시스템 ("시스템")

운영 체제 초기화 프로세스에서 시작된 디바이스 드라이버입니다. 이 값은 드라이버 서비스에 대해서만 유효합니다.

Auto ("Auto")

시스템이 시작되는 동안 서비스 제어 관리자가 자동으로 시작하는 서비스입니다.

수동 ("수동")

프로세스가 StartService 메서드를 호출할 때 서비스 제어 관리자가 시작할 서비스입니다.

사용 안 함 ("사용 안 함")

더 이상 시작할 수 없는 서비스입니다.

StartName

데이터 형식: 문자열

액세스 형식: 읽기 전용

한정자: MappingStrings ("Win32API| 서비스 구조| QUERY_SERVICE_CONFIG|lpServiceStartName"), DisplayName ("시작 계정 이름")

서비스가 실행되는 계정 이름입니다. 서비스 유형에 따라 계정 이름은 "DomainName\Username" 또는 UPN 형식(Username@DomainName) 형식일 수 있습니다. 서비스 프로세스는 실행될 때 이러한 두 가지 양식 중 하나를 사용하여 기록됩니다. 계정이 기본 제공 도메인에 속하는 경우 ".\Username"을 지정할 수 있습니다. NULL을 지정하면 서비스가 LocalSystem 계정으로 로그온됩니다. 커널 또는 시스템 수준 드라이버의 경우 StartName 에는 I/O(입력 및 출력) 시스템이 디바이스 드라이버를 로드하는 데 사용하는 드라이버 개체 이름(즉, \FileSystem\Rdr 또는 \Driver\Xns)이 포함됩니다. 또한 NULL 을 지정하면 드라이버가 서비스 이름에 따라 I/O 시스템에서 만든 기본 개체 이름으로 실행됩니다. 예: "DWDOM\관리".

State

데이터 형식: 문자열

액세스 형식: 읽기/쓰기

한정자: MappingStrings ("Win32API| 서비스 구조| SERVICE_STATUS|dwCurrentState "), DisplayName ("State")

기본 서비스의 현재 상태입니다.

중지됨 ("중지됨")

보류 중인 시작 ("보류 중인 시작")

보류 중 중지 ("보류 중 중지")

실행 중 ("실행 중")

계속 보류 중 ("계속 보류 중")

보류 중 일시 중지 ("보류 중 일시 중지")

일시 중지됨 ("일시 중지됨")

알 수 없음 ("알 수 없음")

Windows Server 2008 및 Windows Vista: 이 속성은 읽기 전용입니다.

상태

데이터 형식: 문자열

액세스 형식: 읽기 전용

한정자: MaxLen (10), DisplayName ("상태")

개체의 현재 상태. 다양한 운영 및 비 운용 상태를 정의할 수 있습니다. 작동 상태에는 "OK", "Degraded", "Pred Fail"(SMART 지원 하드 디스크 드라이브와 같은 요소가 제대로 작동하지만 가까운 장래에 오류를 예측할 수 있음)이 포함됩니다. 비 운용성 상태에는 "오류", "시작 중", "중지" 및 "서비스"가 포함됩니다. 후자의 "서비스"는 디스크를 다시 미러, 사용자 권한 목록의 다시 로드 또는 기타 관리 작업 중에 적용할 수 있습니다. 이러한 모든 작업이 온라인 상태인 것은 아니지만 관리되는 요소는 "OK"도 아니고 다른 상태 중 하나에 있지도 않습니다.

이 속성은 CIM_ManagedSystemElement 상속됩니다.

여기에는 다음 값이 포함됩니다.

OK ("OK")

오류 ("오류")

성능 저하됨 ("Degraded")

알 수 없음 ("알 수 없음")

사전 실패 ("사전 실패")

시작 중("시작")

중지 ("중지")

서비스 ("서비스")

스트레스( "스트레스")

NonRecover ("NonRecover")

연락처 없음 ("연락처 없음")

Lost Comm ("Lost Comm")

SystemCreationClassName

데이터 형식: 문자열

액세스 형식: 읽기 전용

한정자: 전파됨 ("CIM_System. CreationClassName"), CIM_Key, DisplayName ("시스템 클래스 이름")

이 서비스를 호스트하는 시스템의 이름을 입력합니다.

이 속성은 CIM_Service 상속됩니다.

SystemName

데이터 형식: 문자열

액세스 형식: 읽기 전용

한정자: 전파됨 ("CIM_System. Name"), CIM_Key, DisplayName ("시스템 이름")

이 서비스를 호스트하는 시스템의 이름입니다.

이 속성은 CIM_Service 상속됩니다.

TagId

데이터 형식: uint32

액세스 형식: 읽기 전용

한정자: MappingStrings ("Win32API| 서비스 구조| QUERY_SERVICE_CONFIG|dwTagId"), DisplayName ("태그 ID")

그룹의 이 서비스에 대한 고유 태그 값입니다. 값이 0이면 서비스에 태그가 할당되지 않았습니다. 태그는 다음 위치에 있는 레지스트리에서 태그 순서 벡터를 지정하여 부하 순서 그룹 내에서 서비스 star tup을 정렬하는 데 사용할 수 있습니다. HKEY_LOCAL_MACHINE\System\CurrentControlSet\Control\GroupOrderList. 태그는 부팅 또는 시스템 시작 모드가 있는 커널 드라이버 및 파일 시스템 드라이버 시작 유형 서비스에 대해서만 평가됩니다.

설명

Win32_BaseService 클래스는 CIM_Service 파생됩니다.

요구 사항

요구 사항 값
지원되는 최소 클라이언트
 Windows Vista
지원되는 최소 서버
 Windows Server 2008
네임스페이스
 Root\CIMV2
MOF
CIMWin32.mof
DLL
CIMWin32.dll

추가 정보

CIM_Service

운영 체제 클래스