SERVICE_TYPE_VALUE_ABSA structure (nspapi.h)
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_ABSA {
DWORD dwNameSpace;
DWORD dwValueType;
DWORD dwValueSize;
LPSTR lpValueName;
PVOID lpValue;
} SERVICE_TYPE_VALUE_ABSA, *PSERVICE_TYPE_VALUE_ABSA, *LPSERVICE_TYPE_VALUE_ABSA;
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:
dwValueType
Type: DWORD
The type of the value data. Specify one of the following types:
Value | Meaning |
---|---|
|
Binary data in any form. |
|
A 32-bit number. |
|
An array of null-terminated strings, terminated by two null characters. |
|
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.
Constant | Meaning |
---|---|
|
"SapId" |
|
"ConnectionOriented" |
|
"TcpPort" |
|
"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.
Note
The nspapi.h header defines SERVICE_TYPE_VALUE_ABS as an alias which automatically selects the ANSI or Unicode version of this function based on the definition of the UNICODE preprocessor constant. Mixing usage of the encoding-neutral alias with code that not encoding-neutral can lead to mismatches that result in compilation or runtime errors. For more information, see Conventions for Function Prototypes.
Requirements
Requirement | Value |
---|---|
Minimum supported client | Windows 2000 Professional [desktop apps only] |
Minimum supported server | Windows 2000 Server [desktop apps only] |
Header | nspapi.h |