QueryServiceConfigA 函式（winsvc.h）

發行項
11/20/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。

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

傳回碼	描述
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 [僅限傳統型應用程式]
目標平臺	窗戶
標頭	winsvc.h （包括 Windows.h）
連結庫	Advapi32.lib
DLL	Advapi32.dll