Share via


CloseServiceHandle 函式 (winsvc.h)

關閉服務控制管理員或服務物件的句柄。

語法

BOOL CloseServiceHandle(
  [in] SC_HANDLE hSCObject
);

參數

[in] hSCObject

要關閉的服務控制管理員對象或服務物件的句柄。 對服務控制管理員物件的句柄是由 OpenSCManager 函 式傳回,而服務物件的句柄是由 OpenServiceCreateService 函式傳回。

傳回值

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

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

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

傳回碼 Description
ERROR_INVALID_HANDLE
指定的句柄無效。

備註

CloseServiceHandle 函式不會終結句柄所參考的服務控制管理員物件。 無法終結服務控制管理員物件。 呼叫 DeleteService 函式即可終結服務物件。

範例

如需範例,請參閱 刪除服務

規格需求

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

另請參閱

CreateService

DeleteService

OpenSCManager

OpenService

SCM 句柄

服務函式