GetServiceDisplayNameA 函式 （winsvc.h）

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

語法

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

參數

[in] hSCManager

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

[in] lpServiceName

服務名稱。 此名稱與服務的登錄機碼名稱相同。 最好選擇少於 256 個字元的名稱。

[out, optional] lpDisplayName

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

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

這個參數可以使用下列格式來指定本地化的字串：

@[路徑]dllname，-strID

標識子 strID 的字串會從 dllname載入;路徑 是選擇性的。 如需詳細資訊，請參閱 RegLoadMUIString。

Windows Server 2003 和 Windows XP：在 Windows Vista 之前不支援 當地語系化字串。

[in, out] lpcchBuffer

變數的指標，指定 lpDisplayName所指向之緩衝區的大小，TCHAR。

在輸出中，此變數會接收服務顯示名稱的大小，以字元為單位，但不包括 Null 終止字元。

如果 lpDisplayName 所指向的緩衝區 太小而無法包含顯示名稱，函式就不會儲存它。 當函式傳回時，lpcchBuffer 包含服務顯示名稱的大小，但不包括 null 終止字元。

傳回值

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

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

言論

服務有兩個名稱：服務名稱和顯示名稱。 服務名稱是登錄中服務機碼的名稱。 顯示名稱是顯示在 Services 控制面板應用程式中的使用者易記名稱，且會與 NET START 命令搭配使用。 若要將服務名稱對應至顯示名稱，請使用 getServiceDisplayName 函式 。 若要將顯示名稱對應至服務名稱，請使用 GetServiceKeyName 函式。

要求

另請參閱

GetServiceKeyNameOpenSCManagerService Functions