Share via


SERVICE_DESCRIPTIONA 結構 (winsvc.h)

包含服務描述。

語法

typedef struct _SERVICE_DESCRIPTIONA {
  LPSTR lpDescription;
} SERVICE_DESCRIPTIONA, *LPSERVICE_DESCRIPTIONA;

成員

lpDescription

服務的描述。 如果這個成員是 Null,描述會保持不變。 如果此值是空字串 (「」) ,則會刪除目前的描述。

服務描述不能超過類型 REG_SZ的登錄值大小。

此成員可以使用下列格式來指定當地語系化字串:

@[path]dllname,-strID

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

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

備註

Null的描述表示沒有任何服務描述存在。 建立服務時,服務描述為 Null。

描述只是說明服務用途的批註。 例如,針對 DHCP 服務,您可以使用描述「為網路上的電腦提供網際網路位址」。

您可以使用 ChangeServiceConfig2 函式來設定描述。 您可以使用 QueryServiceConfig2 函式來擷取描述。 服務嵌入式管理單元也會顯示描述。

範例

如需範例,請參閱 變更服務的組態查詢服務的組態

注意

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

規格需求

   
最低支援的用戶端 Windows XP [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2003 [僅限傳統型應用程式]
標頭 winsvc.h (包括 Windows.h)

另請參閱

ChangeServiceConfig2

QueryServiceConfig2