enumDependentServicesW 函式 (winsvc.h)

發行項
03/04/2024

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

語法

BOOL EnumDependentServicesW(
  [in]            SC_HANDLE              hService,
  [in]            DWORD                  dwServiceState,
  [out, optional] LPENUM_SERVICE_STATUSW 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錯誤表示;否則，不會定義其內容。

[out] lpServicesReturned

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

傳回值

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

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

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

傳回碼	Description
ERROR_ACCESS_DENIED	句柄沒有 SERVICE_ENUMERATE_DEPENDENTS 訪問許可權。
ERROR_INVALID_HANDLE	指定的句柄無效。
ERROR_INVALID_PARAMETER	指定的參數無效。
ERROR_MORE_DATA	lpServices 所指向的緩衝區不夠大。函式會將 lpServicesReturned 指向的變數設定為儲存至緩衝區的實際服務項目數目。此函式會將由 HTTPBytesNeeded 指向的變數設定為儲存所有服務專案所需的位元元組數目。

備註

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

範例

如需範例，請參閱停止服務。

注意

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

規格需求

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