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
變數的指標，指定TCHAR中lpServiceName參數所指向的緩衝區大小。 當函式傳回時，此參數會在 TCHAR中包含服務名稱的大小，不包括 null 終止字元。
如果 lpServiceName 所指向的緩衝區太小而無法包含服務名稱，則函式不會儲存任何資料。 當函式傳回時， lpcchBuffer 會包含服務名稱的大小，不包括 Null 結束字元。
傳回值
如果函式成功，則傳回值為非零。
如果此函式失敗，則傳回值為零。 若要取得擴充的錯誤資訊，請呼叫 GetLastError。
備註
服務有兩個名稱：服務名稱和顯示名稱。 服務名稱是登錄中服務機碼的名稱。 顯示名稱是顯示在服務控制台應用程式中的使用者易記名稱，並搭配 NET START 命令使用。 這兩個名稱都是使用 CreateService 函式來指定，而且可以使用 ChangeServiceConfig 函式進行修改。 針對服務所指定的資訊會儲存在名稱與HKEY_LOCAL_MACHINE\System\CurrentControlSet\Services ServiceName\ 登錄機碼下的服務名稱相同的機碼中。
若要將服務名稱對應至顯示名稱，請使用 GetServiceDisplayName 函式。 若要將顯示名稱對應至服務名稱，請使用 GetServiceKeyName 函式。
注意
winsvc.h 標頭會根據 UNICODE 預處理器常數的定義，將 GetServiceKeyName 定義為別名，自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程式碼，可能會導致編譯或執行時間錯誤不符。 如需詳細資訊，請參閱 函式原型的慣例。
規格需求
| 最低支援的用戶端 | Windows XP [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows Server 2003 [僅限傳統型應用程式] |
| 目標平台 | Windows |
| 標頭 | winsvc.h (包括 Windows.h) |
| 程式庫 | Advapi32.lib |
| Dll | Advapi32.dll |