Export (0) Print
Expand All

SERVICE_TYPE_VALUE_ABS structure

The SERVICE_TYPE_VALUE_ABS structure contains information about a network-service type value. This information may be specific to a namespace.

Syntax


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

Members

dwNameSpace

Type: DWORD

A namespace, or a set of default namespaces, for which the network service type value is intended. Namespace providers will look only at values intended for their namespace.

Use one of the following constants to specify a namespace:

ValueMeaning
NS_DEFAULT

A set of default namespaces. The function queries each namespace within this set. The set of default namespaces typically includes all the namespaces installed on the system. System administrators, however, can exclude particular namespaces 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 operating systems register their computer names with NetBIOS. This namespace 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 namespace 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: DWORD

The type of the value data. Specify one of the following types:

ValueMeaning
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

Type: DWORD

The size, in bytes, of the value pointed to by the lpValue member. In the case of REG_SZ and REG_MULTI_SZ string data, the terminating characters are counted as part of the size.

lpValueName

Type: LPTSTR

A pointer to a NULL-terminated string that is the name of the value. This name is specific to a namespace.

Several commonly used value name strings are associated with defined constants. These name strings include the following.

ConstantMeaning
SERVICE_TYPE_VALUE_SAPID

"SapId"

SERVICE_TYPE_VALUE_CONN

"ConnectionOriented"

SERVICE_TYPE_VALUE_TCPPORT

"TcpPort"

SERVICE_TYPE_VALUE_UDPPORT

"UdpPort"

 

lpValue

Type: PVOID

A pointer to the value data.

Remarks

When you use the SetService function to add a network service type to a namespace, a SERVICE_TYPE_INFO_ABS structure is passed as the ServiceSpecificInfo BLOB member of a SERVICE_INFO structure. Although the ServiceSpecificInfo member generally should not contain pointers, an exception is made in the case of the SERVICE_TYPE_INFO_ABS and SERVICE_TYPE_VALUE_ABS structures.

Requirements

Minimum supported client

Windows 2000 Professional [desktop apps only]

Minimum supported server

Windows 2000 Server [desktop apps only]

Header

Nspapi.h

Unicode and ANSI names

SERVICE_TYPE_VALUE_ABSW (Unicode) and SERVICE_TYPE_VALUE_ABSA (ANSI)

See also

SetService
SERVICE_INFO
SERVICE_TYPE_INFO_ABS

 

 

Community Additions

ADD
Show:
© 2014 Microsoft