共用方式為

GetServiceKeyNameA 函式 （winsvc.h）

  • 發行項

擷取指定服務的服務名稱。

語法

BOOL GetServiceKeyNameA(
  [in]            SC_HANDLE hSCManager,
  [in]            LPCSTR    lpDisplayName,
  [out, optional] LPSTR     lpServiceName,
  [in, out]       LPDWORD   lpcchBuffer
);

參數

[in] hSCManager

計算機服務控制管理員資料庫的句柄，如 OpenSCManager所傳回。

[in] lpDisplayName

服務顯示名稱。 此字串的長度上限為 256 個字元。

[out, optional] lpServiceName

接收服務名稱之緩衝區的指標。 如果函式失敗，此緩衝區將會包含空字串。

此陣列的大小上限為4K個字節。 若要判斷所需的大小，請為此參數指定 NULL，併為 lpcchBuffer 參數指定 0。 函式將會失敗，GetLastError 會傳回 ERROR_INSUFFICIENT_BUFFER。 lpcchBuffer 參數會收到所需的大小。

[in, out] lpcchBuffer

變數的指標，指定 lpServiceName 參數所指向的緩衝區大小，TCHAR。 當函式傳回時，此參數會包含服務名稱的大小，TCHAR，但不包括 null 終止字元。

如果 lpServiceName 所指向的緩衝區太小而無法包含服務名稱，則函式不會儲存其中的數據。 當函式傳回時，lpcchBuffer 包含服務名稱的大小，但不包括 NULL 終止符。

傳回值

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

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

言論

服務有兩個名稱：服務名稱和顯示名稱。 服務名稱是登錄中服務機碼的名稱。 顯示名稱是顯示在 Services 控制面板應用程式中的使用者易記名稱，且會與 NET START 命令搭配使用。 這兩個名稱都是使用 CreateService 函式來指定，而且可以使用 ChangeServiceConfig 函式來修改。 為服務指定的資訊會儲存在與 HKEY_LOCAL_MACHINESystemCurrentControlSetServiceNameServiceName 登錄機碼下之服務名稱相同的機碼中。

若要將服務名稱對應至顯示名稱，請使用 getServiceDisplayName 函式 。 若要將顯示名稱對應至服務名稱，請使用 GetServiceKeyName 函式。

注意

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

要求

要求 價值
最低支援的用戶端 Windows XP [僅限傳統型應用程式]
支援的最低伺服器 Windows Server 2003 [僅限傳統型應用程式]
目標平臺 窗戶
標頭 winsvc.h （包括 Windows.h）
連結庫 Advapi32.lib
DLL Advapi32.dll

另請參閱

GetServiceDisplayName

OpenSCManager

Service Functions