EnumDependentServicesA 함수(winsvc.h)
지정된 서비스에 따라 달라지는 각 서비스의 이름과 상태를 검색합니다. 즉, 종속 서비스를 실행하려면 먼저 지정된 서비스를 실행해야 합니다.
통사론
BOOL EnumDependentServicesA(
[in] SC_HANDLE hService,
[in] DWORD dwServiceState,
[out, optional] LPENUM_SERVICE_STATUSA lpServices,
[in] DWORD cbBufSize,
[out] LPDWORD pcbBytesNeeded,
[out] LPDWORD lpServicesReturned
);
매개 변수
[in] hService
서비스에 대한 핸들입니다. 이 핸들은 OpenService 또는 CreateService 함수에서 반환되며 SERVICE_ENUMERATE_DEPENDENTS 액세스 권한이 있어야 합니다. 자세한 내용은 Service Security and Access Rights참조하세요.
[in] dwServiceState
열거할 서비스의 상태입니다. 이 매개 변수는 다음 값 중 하나일 수 있습니다.
[out, optional] lpServices
데이터베이스의 각 종속 서비스에 대한 이름 및 서비스 상태 정보를 수신하는 ENUM_SERVICE_STATUS 구조의 배열에 대한 포인터입니다. 버퍼는 구조체와 멤버가 가리키는 문자열을 포함할 수 있을 만큼 커야 합니다.
이 배열의 서비스 순서는 서비스의 시작 순서와 반대입니다. 즉, 배열의 첫 번째 서비스는 마지막으로 시작될 서비스이고 배열의 마지막 서비스는 먼저 시작될 서비스입니다.
이 배열의 최대 크기는 64,000바이트입니다. 필요한 크기를 확인하려면 이 매개 변수에 NULL, cbBufSize 매개 변수에 대해 0을 지정합니다. 함수가 실패하고 GetLastError
[in] cbBufSize
lpServices 매개 변수가 가리키는 버퍼의 크기(바이트)입니다.
[out] pcbBytesNeeded
서비스 항목의 배열을 저장하는 데 필요한 바이트 수를 받는 변수에 대한 포인터입니다. 변수는 lpServices 가리키는 버퍼가 너무 작아서 함수 오류 및 ERROR_MORE_DATA 오류로 표시되는 경우에만 이 값을 받습니다. 그렇지 않으면 pcbBytesNeeded 내용이 정의되지 않습니다.
[out] lpServicesReturned
반환되는 서비스 항목 수를 받는 변수에 대한 포인터입니다.
반환 값
함수가 성공하면 반환 값은 0이 아닌 값입니다.
함수가 실패하면 반환 값은 0입니다. 확장 오류 정보를 얻으려면 GetLastError호출합니다.
서비스 제어 관리자가 다음 오류 코드를 설정할 수 있습니다. 다른 오류 코드는 서비스 제어 관리자가 호출하는 레지스트리 함수에 의해 설정될 수 있습니다.
| 반환 코드 | 묘사 |
|---|---|
|
핸들에 SERVICE_ENUMERATE_DEPENDENTS 액세스 권한이 없습니다. |
|
지정한 핸들이 잘못되었습니다. |
|
지정한 매개 변수가 잘못되었습니다. |
|
lpServices 가리키는 버퍼가 충분히 크지 않습니다. 이 함수는 lpServicesRe가 가리키는 변수를 버퍼에 저장된 실제 서비스 항목 수로 설정합니다. 이 함수는 pcbBytesNeeded 가리키는 변수를 모든 서비스 항목을 저장하는 데 필요한 바이트 수로 설정합니다. |
발언
반환된 서비스 항목은 그룹 순서를 고려하여 시작 순서의 역순으로 정렬됩니다. 종속 서비스를 중지해야 하는 경우 lpServices 버퍼에 기록된 항목의 순서를 사용하여 종속 서비스를 적절한 순서로 중지할 수 있습니다.
예제
예를 들어 서비스중지를 참조하세요.
메모
winsvc.h 헤더는 ENumDependentServices를 유니코드 전처리기 상수의 정의에 따라 이 함수의 ANSI 또는 유니코드 버전을 자동으로 선택하는 별칭으로 정의합니다. 인코딩 중립 별칭을 인코딩 중립이 아닌 코드와 혼합하면 컴파일 또는 런타임 오류가 발생하는 불일치가 발생할 수 있습니다. 자세한 내용은 함수 프로토타입대한
요구 사항
| 요구 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows XP [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows Server 2003 [데스크톱 앱만 해당] |
| 대상 플랫폼 | Windows |
| 헤더 | winsvc.h(Windows.h 포함) |
| 라이브러리 | Advapi32.lib |
| DLL | Advapi32.dll |
참고 항목
CreateService
OpenService