Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
A version of this page is also available for
4/8/2010

This structure contains information about a network-service type value. This information may be specific to a name space.

Syntax 

typedef struct _SERVICE_TYPE_VALUE_ABS { 
  DWORD 
dwNameSpace; 
  DWORD 
dwValueType; 
  DWORD 
dwValueSize; 
  LPTSTR 
lpValueName; 
  PVOID 
lpValue; 
} SERVICE_TYPE_VALUE_ABS;

Members

dwNameSpace

Specifies the name space, or a set of default name spaces, for which the network service type value is intended. Name-space providers will look only at values intended for their name space.

The following table shows the constants you use to specify a name space.

Value Name space

NS_DEFAULT

A set of default name spaces. The function queries each name space within this set. The set of default name spaces typically includes all the name spaces installed on the system. System administrators, however, can exclude particular name spaces from the set. NS_DEFAULT is the value that most applications should use for dwNameSpace.

NS_DNS

The Domain Name System used in the Internet for host name resolution.

NS_NETBT

The NetBIOS over TCP/IP layer. All Windows NT® and Windows® 2000 systems register their computer names with NetBIOS. This name space is used to convert a computer name to an IP address that uses this registration. Note that NS_NETBT may access a WINS server to perform the resolution.

NS_SAP

The Netware Service Advertising Protocol. This may access the Netware bindery if appropriate. NS_SAP is a dynamic name space that allows registration of services.

NS_TCPIP_HOSTS

Lookup value in the <systemroot>\system32\drivers\etc\hosts file.

NS_TCPIP_LOCAL

Local TCP/IP name resolution mechanisms, including comparisons against the local host name and looks up host names and IP addresses in cache of host to IP address mappings.
dwValueType

Type of the value data. The following table shows the types you can specify.

Value Description

REG_BINARY

Binary data in any form.

REG_DWORD

A 32-bit number.

REG_MULTI_SZ

An array of null-terminated strings, terminated by two null characters.

REG_SZ

A null-terminated string.
dwValueSize

Size of the value data, in bytes. In the case of REG_SZ and REG_MULTI_SZ string data, the terminating characters are counted as part of the size.

lpValueName

Pointer to a zero-terminated string that is the name of the value. This name is specific to a name space.

Several commonly used value name strings are associated with defined constants. The following table shows the available name strings.

Constant Name string

SERVICE_TYPE_VALUE_SAPID

"SapId"

SERVICE_TYPE_VALUE_CONN

"ConnectionOriented"

SERVICE_TYPE_VALUE_TCPPORT

"TcpPort"

SERVICE_TYPE_VALUE_UDPPORT

"UdpPort"
lpValue

Pointer to the value data.

Requirements

Header winsock2.h
Windows Embedded CE Windows CE .NET 4.0 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also