enumDependentServicesA 函式 (winsvc.h)

發行項
08/27/2023

擷取相依于指定服務之每個服務的名稱和狀態;也就是說，指定的服務必須先執行，才能執行相依服務。

語法

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存取權限。如需詳細資訊，請參閱服務安全性和存取權限。

[in] dwServiceState

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

值	意義
SERVICE_ACTIVE 0x00000001	列舉處於下列狀態的服務：SERVICE_START_PENDING、SERVICE_STOP_PENDING、SERVICE_RUNNING、SERVICE_CONTINUE_PENDING、SERVICE_PAUSE_PENDING和SERVICE_PAUSED。
SERVICE_INACTIVE 0x00000002	列舉處於SERVICE_STOPPED 狀態的服務。
SERVICE_STATE_ALL 0x00000003	結合下列狀態： SERVICE_ACTIVE 和 SERVICE_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