Share via


SERVICE_DESCRIPTIONA 구조체(winsvc.h)

서비스 설명을 포함합니다.

구문

typedef struct _SERVICE_DESCRIPTIONA {
  LPSTR lpDescription;
} SERVICE_DESCRIPTIONA, *LPSERVICE_DESCRIPTIONA;

멤버

lpDescription

서비스에 대한 설명입니다. 이 멤버가 NULL인 경우 설명은 변경되지 않은 상태로 유지됩니다. 이 값이 빈 문자열("")이면 현재 설명이 삭제됩니다.

서비스 설명은 REG_SZ 형식의 레지스트리 값 크기를 초과해서는 안됩니다.

이 멤버는 다음 형식을 사용하여 지역화된 문자열을 지정할 수 있습니다.

@[path]dllname,-strID

식별자 strID 가 있는 문자열은 dllname에서 로드됩니다. 경로 는 선택 사항입니다. 자세한 내용은 RegLoadMUIString을 참조하세요.

Windows Server 2003 및 Windows XP: 지역화된 문자열은 Windows Vista까지 지원되지 않습니다.

설명

NULL에 대한 설명은 서비스 설명이 없음을 나타냅니다. 서비스를 만들 때 서비스 설명은 NULL입니다.

설명은 단순히 서비스의 목적을 설명하는 주석입니다. 예를 들어 DHCP 서비스의 경우 "네트워크의 컴퓨터에 대한 인터넷 주소 제공" 설명을 사용할 수 있습니다.

ChangeServiceConfig2 함수를 사용하여 설명을 설정할 수 있습니다. QueryServiceConfig2 함수를 사용하여 설명을 검색할 수 있습니다. 설명은 서비스 스냅인에서도 표시됩니다.

예제

예를 들어 서비스의 구성 변경 또는 서비스 구성쿼리를 참조하세요.

참고

winsvc.h 헤더는 유니코드 전처리기 상수의 정의에 따라 이 함수의 ANSI 또는 유니코드 버전을 자동으로 선택하는 별칭으로 SERVICE_DESCRIPTION 정의합니다. 인코딩 중립 별칭을 인코딩 중립이 아닌 코드와 혼합하면 컴파일 또는 런타임 오류가 발생하는 불일치가 발생할 수 있습니다. 자세한 내용은 함수 프로토타입에 대한 규칙을 참조하세요.

요구 사항

   
지원되는 최소 클라이언트 Windows XP [데스크톱 앱만 해당]
지원되는 최소 서버 Windows Server 2003 [데스크톱 앱만 해당]
머리글 winsvc.h(Windows.h 포함)

추가 정보

ChangeServiceConfig2

QueryServiceConfig2