LPSERVICE_MAIN_FUNCTIONA回呼函式 (winsvc.h)

發行項
03/04/2024

服務的進入點。

LPSERVICE_MAIN_FUNCTION類型會定義這個回呼函式的指標。 ServiceMain 是應用程式定義函數名稱的佔位元。

語法

LPSERVICE_MAIN_FUNCTIONA LpserviceMainFunctiona;

void LpserviceMainFunctiona(
  [in] DWORD dwNumServicesArgs,
  [in] LPSTR *lpServiceArgVectors
)
{...}

參數

[in] dwNumServicesArgs

lpServiceArgVectors 陣列中的自變數數目。

[in] lpServiceArgVectors

呼叫啟動服務的 StartService 函式，以 Null 終止的自變數字串傳遞至服務。如果沒有自變數，這個參數可以是NULL。否則，第一個自變數 (lpServiceArgVectors[0]) 是服務的名稱，後面接著任何其他自變數 (lpServiceArgVectors[1] 到 lpServiceArgVectors[dwNumServicesArgs-1]) 。

如果使用者從控制台使用 Services 嵌入式管理單元啟動手動服務，lpServiceArgVectors 參數的字串來自服務 (的服務屬性對話框，以滑鼠右鍵按兩下服務專案，按兩下 [屬性]，然後在 [開始參數] 中輸入參數。)

傳回值

無

備註

服務程式可以啟動一或多個服務。服務進程針對可啟動的每個服務，都有一個SERVICE_TABLE_ENTRY 結構。結構會指定該服務的服務名稱和 ServiceMain 函式的指標。

當服務控制管理員收到啟動服務的要求時，如果服務尚未執行) ，它會啟動服務進程 (。服務進程的主要線程會呼叫 StartServiceCtrlDispatcher 函式，其中包含 SERVICE_TABLE_ENTRY 結構的數位指標。然後，服務控制管理員會將啟動要求傳送給此服務進程的服務控制發送器。服務控制發送器會建立新的線程，以執行正在啟動之服務的 ServiceMain 函式。

ServiceMain 函式應該立即呼叫 RegisterServiceCtrlHandlerEx 函式，以指定 HandlerEx 函式來處理控制要求。接下來，它應該呼叫 SetServiceStatus 函式，以將狀態資訊傳送給服務控制管理員。在這些呼叫之後，函式應該會完成服務的初始化。請勿嘗試在 ServiceMain 函式中啟動另一個服務。

服務控制管理員 (SCM) 等到服務回報SERVICE_RUNNING的狀態為止。建議服務儘快報告此狀態，因為系統中需要與 SCM 互動的其他元件會在這段期間遭到封鎖。某些函式可能需要直接或間接與 SCM 互動。

SCM 會在初始化期間鎖定服務控制資料庫，因此如果服務嘗試在初始化期間呼叫 StartService ，則呼叫將會封鎖。當服務回報成功啟動的 SCM 時，它可以呼叫 StartService。如果服務需要另一個服務正在執行，服務應該設定必要的相依性。

此外，您不應該在服務初始化期間呼叫任何系統函式。只有在服務程式代碼報告SERVICE_RUNNING狀態之後，服務程式代碼才應該呼叫系統函式。

ServiceMain 函式應該建立全域事件、在此事件上呼叫 RegisterWaitForSingleObject 函式，然後結束。這會終止執行 ServiceMain 函式的線程，但不會終止服務。當服務停止時，服務控制處理程式應該使用 SERVICE_STOP_PENDING 呼叫 SetServiceStatus ，併發出此事件的訊號。來自線程集區的線程會執行等候回呼函式;此函式應該執行清除工作，包括關閉全域事件，並使用 SERVICE_STOPPED呼叫 SetServiceStatus 。服務停止之後，您不應該執行任何其他服務程式代碼，因為如果服務收到啟動控件，而且 再次呼叫 ServiceMain ，就可能會產生競爭條件。請注意，當多個服務共用進程時，較可能發生這個問題。

範例

如需範例，請參閱撰寫 ServiceMain 函式。

注意

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

規格需求

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