Funzione EnumServicesStatusExW (winsvc.h)

Enumera i servizi nel database di Gestione controllo dei servizi specificato. Vengono forniti il nome e lo stato di ogni servizio, insieme a dati aggiuntivi in base al livello di informazioni specificato.

Sintassi

BOOL EnumServicesStatusExW(
  [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]      LPCWSTR      pszGroupName
);

Parametri

[in] hSCManager

Handle per il database di Gestione controllo dei servizi. Questo handle viene restituito dalla funzione OpenSCManager e deve avere il diritto di accesso SC_MANAGER_ENUMERATE_SERVICE. Per altre informazioni, vedere Service Security and Access Rights.

[in] InfoLevel

Attributi del servizio da restituire. Usare SC_ENUM_PROCESS_INFO per recuperare il nome e le informazioni sullo stato del servizio per ogni servizio nel database. Il parametro lpServices è un puntatore a un buffer che riceve una matrice di strutture ENUM_SERVICE_STATUS_PROCESS. Il buffer deve essere sufficientemente grande da contenere le strutture e le stringhe a cui puntano i relativi membri.

Attualmente non sono definiti altri livelli di informazioni.

[in] dwServiceType

Tipo di servizi da enumerare. Questo parametro può essere uno o più dei valori seguenti.

[in] dwServiceState

Stato dei servizi da enumerare. Questo parametro può essere uno dei valori seguenti.

[out, optional] lpServices

Puntatore al buffer che riceve le informazioni sullo stato. Il formato di questi dati dipende dal valore del parametro InfoLevel.

La dimensione massima di questa matrice è di 256.000 byte. Per determinare le dimensioni necessarie, specificare NULL per questo parametro e 0 per il parametro cbBufSize. La funzione avrà esito negativo e getLastError restituirà ERROR_MORE_DATA. Il parametro pcbBytesNeeded riceverà le dimensioni necessarie.

Windows Server 2003 e Windows XP: La dimensione massima di questa matrice è di 64.000 byte. Questo limite è stato aumentato a partire da Windows Server 2003 con SP1 e Windows XP con SP2.

[in] cbBufSize

Dimensioni del buffer a cui punta il parametro lpServices in byte.

[out] pcbBytesNeeded

Puntatore a una variabile che riceve il numero di byte necessari per restituire le voci del servizio rimanenti, se il buffer è troppo piccolo.

[out] lpServicesReturned

Puntatore a una variabile che riceve il numero di voci del servizio restituite.

[in, out, optional] lpResumeHandle

Puntatore a una variabile che, in input, specifica il punto iniziale dell'enumerazione. È necessario impostare questo valore su zero alla prima chiamata della funzione EnumServicesStatusEx. Nell'output questo valore è zero se la funzione ha esito positivo. Tuttavia, se la funzione restituisce zero e la funzione GetLastError restituisce ERROR_MORE_DATA, questo valore indica la voce di servizio successiva da leggere quando viene chiamata la funzione di EnumServicesStatusEx per recuperare i dati aggiuntivi.

[in, optional] pszGroupName

Nome del gruppo dell'ordine di caricamento. Se questo parametro è una stringa, gli unici servizi enumerati sono quelli che appartengono al gruppo con il nome specificato dalla stringa. Se questo parametro è una stringa vuota, vengono enumerati solo i servizi che non appartengono ad alcun gruppo. Se questo parametro è NULL, l'appartenenza al gruppo viene ignorata e tutti i servizi vengono enumerati.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è diverso da zero.

Se la funzione ha esito negativo, il valore restituito è zero. Per ottenere informazioni estese sull'errore, chiamare GetLastError. È possibile che vengano restituiti gli errori seguenti.

Osservazioni

Se il chiamante non dispone del diritto di accesso SERVICE_QUERY_STATUS a un servizio, il servizio viene omesso automaticamente dall'elenco dei servizi restituiti al client.

Fabbisogno

Vedere anche

ENUM_SERVICE_STATUS_PROCESS

Funzioni del servizio

'installazione, rimozione ed enumerazione del servizio