QueryServiceConfigA 函式 (winsvc.h)

發行項
03/13/2024

擷取指定服務的組態參數。選擇性的組態參數可使用 QueryServiceConfig2 函式。

語法

BOOL QueryServiceConfigA(
  [in]            SC_HANDLE               hService,
  [out, optional] LPQUERY_SERVICE_CONFIGA lpServiceConfig,
  [in]            DWORD                   cbBufSize,
  [out]           LPDWORD                 pcbBytesNeeded
);

參數

[in] hService

服務的句柄。 OpenService 或 CreateService 函式會傳回此句柄，而且必須具有SERVICE_QUERY_CONFIG訪問許可權。如需詳細資訊，請參閱服務安全性和訪問許可權。

[out, optional] lpServiceConfig

接收服務組態信息的緩衝區指標。數據的格式是 QUERY_SERVICE_CONFIG 結構。

此陣列的大小上限為8K位元組。若要判斷所需的大小，請為此參數指定 NULL，並針對 cbBufSize 參數指定 0。函式將會失敗，而且 GetLastError 會傳回ERROR_INSUFFICIENT_BUFFER。其會接收所需的大小。

[in] cbBufSize

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

[out] pcbBytesNeeded

如果函式因ERROR_INSUFFICIENT_BUFFER而失敗，則會接收儲存所有組態資訊所需位元組數目的變數指標。

傳回值

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

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

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

傳回碼	Description
ERROR_ACCESS_DENIED	句柄沒有SERVICE_QUERY_CONFIG訪問許可權。
ERROR_INSUFFICIENT_BUFFER	服務組態資訊比 lpServiceConfig 緩衝區還多。取得所有資訊所需的位元組數目會傳回於參數中。不會寫入 lpServiceConfig。
ERROR_INVALID_HANDLE	指定的句柄無效。

備註

QueryServiceConfig 函式會傳回保留在特定服務登錄中的服務組態資訊。此組態資訊會先由服務控制程式使用 CreateService 函式來設定。這項資訊可能已由服務組態程式使用 ChangeServiceConfig 函式來更新。

如果服務在上次變更組態資訊時執行， QueryServiceConfig 傳回的資訊將不會反映服務的目前設定。相反地，它會在下次執行時反映服務的組態。 DisplayName 機碼是例外狀況。當 DisplayName 金鑰變更時，不論服務是否正在執行，都會立即生效。

範例

如需範例，請參閱查詢服務的設定。

注意

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

規格需求

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