enumServicesStatusExW 函式 (winsvc.h)

列舉指定之服務控制管理員資料庫中的服務。 系統會根據指定的資訊層級提供每個服務的名稱和狀態，以及其他數據。

語法

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
);

參數

[in] hSCManager

服務控制管理員資料庫的句柄。 這個句柄是由 OpenSCManager 函式傳回，而且必須具有 SC_MANAGER_ENUMERATE_SERVICE 訪問許可權。 如需詳細資訊，請參閱 服務安全性和訪問許可權。

[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。 其會接收所需的大小。

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 函 式時，您必須將此值設定為零。 在輸出中，如果函式成功，這個值會是零。 不過，如果函式傳回零，而且 GetLastError 函 式傳回 ERROR_MORE_DATA，則此值表示呼叫 EnumServicesStatusEx 函 式以擷取其他數據時要讀取的下一個服務專案。

[in, optional] pszGroupName

載入順序組名。 如果此參數是字串，唯一列舉的服務就是屬於字串所指定名稱之群組的服務。 如果此參數是空字串，則只會列舉不屬於任何群組的服務。 如果此參數為 NULL，則會忽略群組成員資格，並列舉所有服務。

傳回值

如果函式成功，則傳回非零的值。

如果此函式失敗，則傳回值為零。 若要取得擴充的錯誤資訊，請呼叫 GetLastError。 可能會傳回下列錯誤。

備註

如果呼叫端沒有服務SERVICE_QUERY_STATUS訪問許可權，則會從傳回給客戶端的服務清單中以無 訊息 方式省略服務。

規格需求

另請參閱

ENUM_SERVICE_STATUS_PROCESS

服務函式

服務安裝、移除和列舉