SERVICE_INFOA結構（nspapi.h）

發行項
11/20/2024

SERVICE_INFO 結構包含網路服務或網路服務類型的相關信息。

語法

typedef struct _SERVICE_INFOA {
  LPGUID              lpServiceType;
  LPSTR               lpServiceName;
  LPSTR               lpComment;
  LPSTR               lpLocale;
  DWORD               dwDisplayHint;
  DWORD               dwVersion;
  DWORD               dwTime;
  LPSTR               lpMachineName;
  LPSERVICE_ADDRESSES lpServiceAddress;
  BLOB                ServiceSpecificInfo;
} SERVICE_INFOA, *PSERVICE_INFOA, *LPSERVICE_INFOA;

成員

lpServiceType

類型：LPGUID

GUID 的指標，此 GUID 是網路服務的類型。

lpServiceName

類型：LPTSTR

NULL終止字串的指標，這是網路服務的名稱。

如果您要呼叫 SetService 函式，並將 dwNameSpace 參數設定為 NS_DEFAULT，網路服務名稱必須是一般名稱。一般名稱是網路服務通常稱為的名稱。網路服務的一般名稱範例為「My SQL Server」。。

如果您要使用設定為特定服務名稱的 dwNameSpace 參數呼叫 SetService 函式，網路服務名稱可以是一般名稱或辨別名稱。辨別名稱會使用目錄服務將服務區分為唯一的位置。網路服務的辨別名稱範例是「MS\SYS\NT\DEV\My SQL Server」。。

lpComment

類型：LPTSTR

NULL終止字串的指標，該字串是網路服務的批註或描述。例如，「用於開發升級」。

lpLocale

類型：LPTSTR

包含地區設定資訊的 NULL終止字串指標。

dwDisplayHint

類型：DWORD

如何在網路瀏覽使用者介面中顯示網路服務的提示。這可以是下列其中一個值。

價值	意義
RESOURCEDISPLAYTYPE_DOMAIN	將網路服務顯示為網域。
RESOURCEDISPLAYTYPE_FILE	將網路服務顯示為檔案。
RESOURCEDISPLAYTYPE_GENERIC	用來顯示物件的方法並不重要。
RESOURCEDISPLAYTYPE_GROUP	將網路服務顯示為群組。
RESOURCEDISPLAYTYPE_SERVER	將網路服務顯示為伺服器。
RESOURCEDISPLAYTYPE_SHARE	將網路服務顯示為 Sharepoint。
RESOURCEDISPLAYTYPE_TREE	將網路服務顯示為樹狀結構。

dwVersion

類型：DWORD

網路服務的版本。此值的高字會指定主要版本號碼。此值的低字會指定次要版本號碼。

dwTime

類型：DWORD

保留供日後使用。必須是零。

lpMachineName

類型：LPTSTR

NULL終止字串的指標，這是網路服務執行所在的計算機名稱。

lpServiceAddress

類型：LPSERVICE_ADDRESSES

包含 SERVICE_ADDRESS 結構陣列之 SERVICE_ADDRESSES 結構的指標。每個 SERVICE_ADDRESS 結構都包含網路服務地址的相關信息。

網路服務可以呼叫 getsockname 函式，以判斷系統的本機位址。

ServiceSpecificInfo

類型：BLOB

指定服務定義資訊的 BLOB 結構。

附註一般而言，BLOB 所指向的數據結構 pBlobData 成員不得包含任何指標。這是因為只有網路服務知道數據的格式;在沒有這類知識的情況下複製數據會導致指標失效。如果 pBlobData 所指向的數據包含可變大小的元素，則 pBlobData 的位移可用來指出這些元素的位置。此一般規則有一個例外：pBlobData 指向 SERVICE_TYPE_INFO_ABS 結構時。這是可能的，因為 SERVICE_TYPE_INFO_ABS 結構及其包含的任何 SERVICE_TYPE_VALUE_ABS 結構都是預先定義的，因此操作系統已知其格式。

言論

注意

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

要求

要求	價值
最低支援的用戶端	Windows 2000 Professional [僅限傳統型應用程式]
支援的最低伺服器	Windows 2000 Server [僅限傳統型應用程式]
標頭	nspapi.h