共用方式為


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

服務的控制碼。 OpenServiceCreateService函式會傳回此控制碼,而且必須具有SERVICE_ENUMERATE_DEPENDENTS存取權限。 如需詳細資訊,請參閱 服務安全性和存取權限

[in] dwServiceState

要列舉的服務狀態。 此參數可以是下列其中一個值。

意義
SERVICE_ACTIVE
0x00000001
列舉處於下列狀態的服務:SERVICE_START_PENDINGSERVICE_STOP_PENDING、SERVICE_RUNNINGSERVICE_CONTINUE_PENDINGSERVICE_PAUSE_PENDINGSERVICE_PAUSED
SERVICE_INACTIVE
0x00000002
列舉 處於SERVICE_STOPPED 狀態的服務。
SERVICE_STATE_ALL
0x00000003
結合下列狀態: SERVICE_ACTIVESERVICE_INACTIVE

[out, optional] lpServices

ENUM_SERVICE_STATUS結構的陣列指標,可接收資料庫中每個相依服務的名稱和服務狀態資訊。 緩衝區必須夠大,才能保存結構,加上其成員指向的字串。

此陣列中的服務順序是服務的開始順序反轉。 換句話說,陣列中的第一個服務是最後啟動的服務,而陣列中的最後一個服務則是會先啟動的服務。

此陣列的大小上限為 64,000 個位元組。 若要判斷所需的大小,請為此參數指定 Null ,並針對 cbBufSize 參數指定 0。 函式將會失敗,而且 GetLastError傳回ERROR_MORE_DATA其會接收所需的大小。

[in] cbBufSize

lpServices參數所指向的緩衝區大小,以位元組為單位。

[out] pcbBytesNeeded

變數的指標,可接收儲存服務專案陣列所需的位元組數目。 如果 lpServices 指向的緩衝區太小,由函式失敗和 ERROR_MORE_DATA 錯誤表示,變數只會收到此值;否則, 不會定義 azureBytesNeeded 的內容。

[out] lpServicesReturned

接收傳回之服務專案數目之變數的指標。

傳回值

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

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

服務控制管理員可能會設定下列錯誤碼。 其他錯誤碼可由服務控制管理員所呼叫的登錄函式設定。

傳回碼 描述
ERROR_ACCESS_DENIED
控制碼沒有 SERVICE_ENUMERATE_DEPENDENTS 存取權限。
ERROR_INVALID_HANDLE
指定的控制碼無效。
ERROR_INVALID_PARAMETER
指定的參數無效。
ERROR_MORE_DATA
lpServices指向的緩衝區不夠大。 函式會將 lpServicesReturned 指向的變數設定為儲存在緩衝區中的實際服務專案數目。 此函式會將其所指向的變數 設定 為儲存所有服務專案所需的位元組數目。

備註

傳回的服務專案會以開始順序的反向順序排序,並將群組順序納入考慮。 如果您需要停止相依服務,您可以使用寫入 至 lpServices 緩衝區的專案順序,以適當的順序停止相依服務。

範例

如需範例,請參閱 停止服務

注意

winsvc.h 標頭會將 EnumDependentServices 定義為別名,根據 UNICODE 預處理器常數的定義,自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程式碼,可能會導致編譯或執行時間錯誤不符。 如需詳細資訊,請參閱 函式原型的慣例

規格需求

   
最低支援的用戶端 Windows XP [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2003 [僅限桌面應用程式]
目標平台 Windows
標頭 winsvc.h (包含 Windows.h)
程式庫 Advapi32.lib
Dll Advapi32.dll

另請參閱

CreateService

ENUM_SERVICE_STATUS

EnumServicesStatusEx

OpenService

服務函式

服務安裝、移除和列舉