EnumServicesStatusExA 함수(winsvc.h)

지정된 서비스 제어 관리자 데이터베이스에서 서비스를 열거합니다. 지정된 정보 수준에 따라 추가 데이터와 함께 각 서비스의 이름과 상태가 제공됩니다.

통사론

BOOL EnumServicesStatusExA(
  [in]                SC_HANDLE    hSCManager,
  [in]                SC_ENUM_TYPE InfoLevel,
  [in]                DWORD        dwServiceType,
  [in]                DWORD        dwServiceState,
  [out, optional]     LPBYTE       lpServices,
  [in]                DWORD        cbBufSize,
  [out]               LPDWORD      pcbBytesNeeded,
  [out]               LPDWORD      lpServicesReturned,
  [in, out, optional] LPDWORD      lpResumeHandle,
  [in, optional]      LPCSTR       pszGroupName
);

매개 변수

[in] hSCManager

서비스 제어 관리자 데이터베이스에 대한 핸들입니다. 이 핸들은 OpenSCManager 함수에서 반환되며 SC_MANAGER_ENUMERATE_SERVICE 액세스 권한이 있어야 합니다. 자세한 내용은 Service Security and Access Rights참조하세요.

[in] InfoLevel

반환할 서비스 특성입니다. SC_ENUM_PROCESS_INFO 사용하여 데이터베이스의 각 서비스에 대한 이름 및 서비스 상태 정보를 검색합니다. lpServices 매개 변수는 ENUM_SERVICE_STATUS_PROCESS 구조의 배열을 수신하는 버퍼에 대한 포인터입니다. 버퍼는 구조체와 멤버가 가리키는 문자열을 보유할 수 있을 만큼 커야 합니다.

현재 다른 정보 수준은 정의되지 않습니다.

[in] dwServiceType

열거할 서비스 유형입니다. 이 매개 변수는 다음 값 중 하나 이상일 수 있습니다.

[in] dwServiceState

열거할 서비스의 상태입니다. 이 매개 변수는 다음 값 중 하나일 수 있습니다.

[out, optional] lpServices

상태 정보를 받는 버퍼에 대한 포인터입니다. 이 데이터의 형식은 InfoLevel 매개 변수의 값에 따라 달라집니다.

이 배열의 최대 크기는 256K바이트입니다. 필요한 크기를 확인하려면 이 매개 변수에 NULL, cbBufSize 매개 변수에 대해 0을 지정합니다. 함수가 실패하고 GetLastError ERROR_MORE_DATA반환합니다. pcbBytesNeeded 매개 변수는 필요한 크기를 받습니다.

Windows Server 2003 및 Windows XP: 이 배열의 최대 크기는 64K바이트입니다. 이 제한은 SP1이 있는 Windows Server 2003 및 WINDOWS XP SP2를 사용하여 증가했습니다.

[in] cbBufSize

lpServices 매개 변수가 가리키는 버퍼의 크기(바이트)입니다.

[out] pcbBytesNeeded

버퍼가 너무 작은 경우 나머지 서비스 항목을 반환하는 데 필요한 바이트 수를 받는 변수에 대한 포인터입니다.

[out] lpServicesReturned

반환되는 서비스 항목 수를 받는 변수에 대한 포인터입니다.

[in, out, optional] lpResumeHandle

입력 시 열거형의 시작점을 지정하는 변수에 대한 포인터입니다. EnumServicesStatusEx 함수가 처음 호출되면 이 값을 0으로 설정해야 합니다. 출력에서 함수가 성공하면 이 값은 0입니다. 그러나 함수가 0을 반환하고 GetLastError 함수가 ERROR_MORE_DATA반환하는 경우 이 값은 추가 데이터를 검색하기 위해 EnumServicesStatusEx 함수를 호출할 때 읽을 다음 서비스 항목을 나타냅니다.

[in, optional] pszGroupName

부하 순서 그룹 이름입니다. 이 매개 변수가 문자열인 경우 열거된 유일한 서비스는 문자열로 지정된 이름을 가진 그룹에 속한 서비스입니다. 이 매개 변수가 빈 문자열인 경우 그룹에 속하지 않는 서비스만 열거됩니다. 이 매개 변수가 NULL그룹 멤버 자격은 무시되고 모든 서비스가 열거됩니다.

반환 값

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

함수가 실패하면 반환 값은 0입니다. 확장 오류 정보를 얻으려면 GetLastError호출합니다. 다음 오류가 반환될 수 있습니다.

발언

호출자에게 서비스에 대한 SERVICE_QUERY_STATUS 액세스 권한이 없는 경우 클라이언트에 반환된 서비스 목록에서 서비스가 자동으로 생략됩니다.

요구 사항

참고 항목

ENUM_SERVICE_STATUS_PROCESS

Service Functions

서비스 설치, 제거 및 열거형