SetServiceBits 함수(lmserver.h)
서비스 유형을 서비스 제어 관리자 및 서버 서비스에 등록합니다. 그런 다음 서버 서비스는 등록된 서비스 유형을 현재 지원하는 서비스 유형으로 알려줄 수 있습니다. NetServerGetInfo 및 NetServerEnum 함수는 지정된 컴퓨터의 지원되는 서비스 유형을 가져옵니다.
구문
BOOL NET_API_FUNCTION SetServiceBits(
[in] SERVICE_STATUS_HANDLE hServiceStatus,
[in] DWORD dwServiceBits,
[in] BOOL bSetBitsOn,
[in] BOOL bUpdateImmediately
);
매개 변수
[in] hServiceStatus
서비스의 상태 정보 구조에 대한 핸들입니다. 서비스는 RegisterServiceCtrlHandlerEx 함수를 호출하여 핸들을 가져옵니다.
[in] dwServiceBits
서비스 형식입니다.
특정 비트 플래그(0xC00F3F7B)는 Microsoft에서 사용하도록 예약되어 있습니다. 이러한 비트 플래그가 dwServiceBits에 설정된 경우 오류 ERROR_INVALID_DATA SetServiceBits 함수가 실패합니다. 다음 비트 플래그는 Microsoft에서 사용하도록 예약되어 있습니다.
SV_TYPE_WORKSTATION(0x00000001)
SV_TYPE_SERVER(0x00000002)
SV_TYPE_DOMAIN_CTRL(0x00000008)
SV_TYPE_DOMAIN_BAKCTRL(0x00000010)
SV_TYPE_TIME_SOURCE(0x00000020)
SV_TYPE_AFP(0x00000040)
SV_TYPE_DOMAIN_MEMBER(0x00000100)
SV_TYPE_PRINTQ_SERVER(0x00000200)
SV_TYPE_DIALIN_SERVER(0x00000400)
SV_TYPE_XENIX_SERVER(0x00000800)
SV_TYPE_SERVER_UNIX(0x00000800)
SV_TYPE_NT(0x00001000)
SV_TYPE_WFW(0x00002000)
SV_TYPE_POTENTIAL_BROWSER(0x00010000)
SV_TYPE_BACKUP_BROWSER(0x00020000)
SV_TYPE_MASTER_BROWSER(0x00040000)
SV_TYPE_DOMAIN_MASTER(0x00080000)
SV_TYPE_LOCAL_LIST_ONLY(0x40000000)
SV_TYPE_DOMAIN_ENUM(0x80000000)
특정 비트 플래그(0x00300084)는 Microsoft에서 정의하지만 시스템 소프트웨어용으로 특별히 예약되지는 않습니다. 다음은 이러한 비트 플래그입니다.
SV_TYPE_SV_TYPE_SQLSERVER(0x00000004)
SV_TYPE_NOVELL(0x00000080)
SV_TYPE_DOMAIN_CTRL(0x00100000)
SV_TYPE_DOMAIN_BAKCTRL(0x00200000)
특정 비트 플래그(0x3FC0C000)는 Microsoft에서 정의하지 않으며 해당 사용은 Microsoft에서 조정되지 않습니다. 이러한 비트를 사용하는 애플리케이션 개발자는 다른 애플리케이션에서도 이러한 비트를 사용할 수 있으므로 충돌이 발생할 수 있음을 알고 있어야 합니다. 다음은 이러한 비트 플래그입니다.
0x00004000
0x00008000
0x00400000
0x00800000
0x01000000
0x02000000
0x04000000
0x08000000
0x10000000
0x20000000
[in] bSetBitsOn
이 값이 TRUE이면 dwServiceBit 의 비트가 설정됩니다. 이 값이 FALSE이면 비트를 지워야 합니다.
[in] bUpdateImmediately
이 값이 TRUE이면 서버 서비스는 즉시 업데이트를 수행하는 것입니다. 이 값이 FALSE이면 업데이트가 즉시 수행되지 않습니다.
반환 값
함수가 성공하면 반환 값이 0이 아닙니다.
함수가 실패하면 반환 값은 0입니다. 확장 오류 정보를 가져오려면 GetLastError를 호출합니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows XP [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows Server 2003 [데스크톱 앱만 해당] |
| 대상 플랫폼 | Windows |
| 헤더 | lmserver.h |
| 라이브러리 | Advapi32.lib |
| DLL | Advapi32.dll |