ServiceMain 函式
當服務控制程式要求新服務執行時，服務控制管理員 （SCM） 會啟動服務，並將啟動要求傳送至控制發送器。 控件發送器會建立新的線程，以執行服務的 ServiceMain 函式。 如需範例，請參閱 撰寫 ServiceMain 函式。
ServiceMain 函式應該執行下列工作：
初始化所有全域變數。
立即呼叫 RegisterServiceCtrlHandler 函式，以註冊 Handler 函式，以處理服務的控件要求。 RegisterServiceCtrlHandler 的傳回值是 服務狀態句柄，將在呼叫中用來通知 SCM 的服務狀態。
執行初始化。 如果初始化程式代碼的運行時間預期非常短（少於一秒），則可以直接在 serviceMain 中執行初始化。
如果初始化時間預期超過一秒，服務應該使用下列其中一種初始化技術：
呼叫 SetServiceStatus 函式來報告SERVICE_RUNNING，但在初始化完成之前，不接受任何控件。 此服務會呼叫 setServiceStatus setServiceStatus，並將 dwCurrentState 設定為 SERVICE_RUNNING，dwControlsAccepted 在 SERVICE_STATUS 結構中設定為 0。 這可確保 SCM 在準備好之前，不會將任何控制要求傳送至服務，並釋放 SCM 來管理其他服務。 建議使用這個初始化方法來達到效能，特別是針對自動啟動服務。
報表SERVICE_START_PENDING、不接受任何控件，並指定等候提示。 如果您的服務初始化程式代碼執行預期花費的時間超過初始等候提示值的工作，您的程式代碼必須定期呼叫 SetServiceStatus 函式（可能已修訂的等候提示），以指出進度正在進行中。 只有當初始化進行時，請務必呼叫 SetServiceStatus。 否則，SCM 可以等候服務進入SERVICE_RUNNING狀態，假設您的服務正在進行中，並封鎖其他服務啟動。 除非您確定執行初始化的線程確實正在進行中，否則請勿從個別線程呼叫 SetServiceStatus。
使用此方法的服務也可以指定檢查點值，並在長時間初始化期間定期遞增值。 啟動服務的程式可以呼叫 QueryServiceStatus 或 QueryServiceStatusEx，以從 SCM 取得最新的檢查點值，並使用 值向使用者報告累加進度。
初始化完成時，請呼叫 SetServiceStatus ，將服務狀態設定為 SERVICE_RUNNING，並指定服務準備接受的控件。 如需控件清單，請參閱 SERVICE_STATUS 結構。
執行服務工作，或者，如果沒有暫止的工作，請將控制權傳回給呼叫端。 服務狀態的任何變更都要求呼叫 SetServiceStatus 以報告新的狀態資訊。
如果服務初始化或執行時發生錯誤，服務應該呼叫 SetServiceStatus，以在清除將會冗長的情況下，將服務狀態設定為SERVICE_STOP_PENDING。 清除完成後，請呼叫 SetServiceStatus，將服務狀態設定為從最後一個線程SERVICE_STOPPED終止。 請務必設定 dwServiceSpecificExitCode 和 dwWin32ExitCodeSERVICE_STATUS 結構的成員，以識別錯誤。
相關主題