SERVICE_TYPE_VALUE_ABSA 結構 (nspapi.h)

SERVICE_TYPE_VALUE_ABS 結構包含網路服務類型值的相關信息。 此資訊可能專屬於命名空間。

語法

typedef struct _SERVICE_TYPE_VALUE_ABSA {
  DWORD dwNameSpace;
  DWORD dwValueType;
  DWORD dwValueSize;
  LPSTR lpValueName;
  PVOID lpValue;
} SERVICE_TYPE_VALUE_ABSA, *PSERVICE_TYPE_VALUE_ABSA, *LPSERVICE_TYPE_VALUE_ABSA;

成員

dwNameSpace

類型： DWORD

命名空間或一組預設命名空間，其中網路服務類型值是預定的。 命名空間提供者只會查看其命名空間所適用的值。

使用下列其中一個常數來指定命名空間：

值	意義
NS_DEFAULT	一組預設命名空間。 函式會查詢此集合中的每個命名空間。 預設命名空間集通常包含安裝在系統上的所有命名空間。 不過，系統管理員可以從集合中排除特定命名空間。 NS_DEFAULT是大部分應用程式應該用於 dwNameSpace 的值。
NS_DNS	因特網中用於主機名解析的域名系統。
NS_NETBT	透過 TCP/IP 層的 NetBIOS。 所有 Windows 作業系統都會使用 NetBIOS 註冊其電腦名稱。 此命名空間可用來將計算機名稱轉換成使用此註冊的IP位址。 請注意，NS_NETBT可能會存取 WINS 伺服器來執行解析。
NS_SAP	NetWare 服務廣告通訊協定。 如果適當，這可能會存取 NetWare bindery。 NS_SAP是允許註冊服務的動態命名空間。
NS_TCPIP_HOSTS	systemroot>\system32\drivers\etc\hosts 檔案中的<查閱值。
NS_TCPIP_LOCAL	本機 TCP/IP 名稱解析機制，包括與本機主機名的比較，以及查閱主機快取中的主機名和 IP 位址與 IP 位址對應。

dwValueType

類型： DWORD

值數據的型別。 指定下列其中一種類型：

值	意義
REG_BINARY	任何形式的二進位資料，
REG_DWORD	32 位數位。
REG_MULTI_SZ	以 null 結尾的字串所組成的陣列，整個陣列最後以兩個 null 字元做為結尾。
REG_SZ	null 終止的字串。

dwValueSize

類型： DWORD

lpValue 成員所指向之值的大小，以位元組為單位。 在REG_SZ和REG_MULTI_SZ字串數據的情況下，終止字元會計算為大小的一部分。

lpValueName

類型： LPTSTR

NULL 終止字串的指標，其為值的名稱。 此名稱專屬於命名空間。

數個常用的值名稱字串會與定義的常數相關聯。 這些名稱字串包括下列專案。

常數	意義
SERVICE_TYPE_VALUE_SAPID	“SapId”
SERVICE_TYPE_VALUE_CONN	“ConnectionOriented”
SERVICE_TYPE_VALUE_TCPPORT	“TcpPort”
SERVICE_TYPE_VALUE_UDPPORT	“UdpPort”

lpValue

類型： PVOID

值數據的指標。

備註

當您使用 SetService 函式將網路服務類型新增至命名空間時，SERVICE_TYPE_INFO_ABS結構會傳遞為 SERVICE_INFO 結構的 ServiceSpecificInfo BLOB 成員。 雖然 ServiceSpecificInfo 成員通常不應該包含指標，但在 SERVICE_TYPE_INFO_ABS 和 SERVICE_TYPE_VALUE_ABS 結構的情況下，就會發生例外狀況。

注意

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

規格需求

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

另請參閱

SERVICE_INFO

SERVICE_TYPE_INFO_ABS

SetService