SERVICE_INFOA 結構 (nspapi.h)

發行項
03/05/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 的指標，這是網路服務的類型。

lpServiceName

類型： LPTSTR

為網路服務名稱之 NULL 終止字串的指標。

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

如果您要呼叫 SetService 函式，並將 dwNameSpace 參數設定為特定服務名稱，則網路服務名稱可以是一般名稱或辨別名稱。辨別名稱會使用目錄服務將服務區別為唯一的位置。網路服務的辨別名稱範例是「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 專業版 [僅限傳統型應用程式]
最低支援的伺服器	Windows 2000 Server [僅限傳統型應用程式]
標頭	nspapi.h