SERVICE_TYPE_VALUE_ABSW-Struktur (nspapi.h)

Die SERVICE_TYPE_VALUE_ABS-Struktur enthält Informationen zu einem Netzwerkdiensttypwert. Diese Informationen können spezifisch für einen Namespace sein.

Syntax

typedef struct _SERVICE_TYPE_VALUE_ABSW {
  DWORD  dwNameSpace;
  DWORD  dwValueType;
  DWORD  dwValueSize;
  LPWSTR lpValueName;
  PVOID  lpValue;
} SERVICE_TYPE_VALUE_ABSW, *PSERVICE_TYPE_VALUE_ABSW, *LPSERVICE_TYPE_VALUE_ABSW;

Member

dwNameSpace

Art: DWORD

Ein Namespace oder eine Gruppe von Standardnamespaces, für die der Wert des Netzwerkdiensttyps vorgesehen ist. Namespaceanbieter betrachten nur Werte, die für ihren Namespace vorgesehen sind.

Verwenden Sie eine der folgenden Konstanten, um einen Namespace anzugeben:

Wert	Bedeutung
NS_DEFAULT	Ein Satz von Standardnamespaces. Die Funktion fragt jeden Namespace innerhalb dieses Satzes ab. Der Satz von Standardnamespaces umfasst in der Regel alle Namespaces, die auf dem System installiert sind. Systemadministratoren können jedoch bestimmte Namespaces aus dem Satz ausschließen. NS_DEFAULT ist der Wert, den die meisten Anwendungen für dwNameSpace verwenden sollten.
NS_DNS	Das Domänennamensystem, das im Internet für die Hostnamenauflösung verwendet wird.
NS_NETBT	Die NetBIOS-Ebene über TCP/IP. Alle Windows-Betriebssysteme registrieren ihre Computernamen bei NetBIOS. Dieser Namespace wird verwendet, um einen Computernamen in eine IP-Adresse zu konvertieren, die diese Registrierung verwendet. Beachten Sie, dass NS_NETBT auf einen WINS-Server zugreifen können, um die Auflösung auszuführen.
NS_SAP	Das NetWare Service Advertising-Protokoll. Dies kann ggf. auf die NetWare-Bindery zugreifen. NS_SAP ist ein dynamischer Namespace, der die Registrierung von Diensten ermöglicht.
NS_TCPIP_HOSTS	Suchwert in der <Datei systemroot>\system32\drivers\etc\hosts.
NS_TCPIP_LOCAL	Lokale TCP/IP-Namensauflösungsmechanismen, einschließlich Vergleichen mit dem lokalen Hostnamen und Suchen nach Hostnamen und IP-Adressen im Cache von Host-zu-IP-Adresszuordnungen.

dwValueType

Art: DWORD

Der Typ der Wertdaten. Geben Sie einen der folgenden Typen an:

Wert	Bedeutung
REG_BINARY	Binärdaten in beliebiger Form.
REG_DWORD	Eine 32-Bit-Zahl.
REG_MULTI_SZ	Ein Array von auf NULL endenden Zeichenfolgen, das auf zwei NULL-Zeichen endet.
REG_SZ	Eine NULL-terminierte Zeichenfolge.

dwValueSize

Art: DWORD

Die Größe des Werts in Bytes, auf den der lpValue-Member verweist. Bei REG_SZ und REG_MULTI_SZ Zeichenfolgendaten werden die abschlussenden Zeichen als Teil der Größe gezählt.

lpValueName

Typ: LPTSTR

Ein Zeiger auf eine NULL-beendete Zeichenfolge, bei der es sich um den Namen des Werts handelt. Dieser Name ist spezifisch für einen Namespace.

Mehrere häufig verwendete Wertnamenszeichenfolgen sind definierten Konstanten zugeordnet. Diese Namenszeichenfolgen enthalten Folgendes.

Konstante	Bedeutung
SERVICE_TYPE_VALUE_SAPID	"SapId"
SERVICE_TYPE_VALUE_CONN	"ConnectionOriented"
SERVICE_TYPE_VALUE_TCPPORT	"TcpPort"
SERVICE_TYPE_VALUE_UDPPORT	"UdpPort"

lpValue

Typ: PVOID

Ein Zeiger auf die Wertdaten.

Hinweise

Wenn Sie die SetService-Funktion verwenden, um einem Namespace einen Netzwerkdiensttyp hinzuzufügen, wird eine SERVICE_TYPE_INFO_ABS-Struktur als ServiceSpecificInfo-BLOB-Member einer SERVICE_INFO-Struktur übergeben. Obwohl das ServiceSpecificInfo-Element in der Regel keine Zeiger enthalten sollte, wird im Fall der SERVICE_TYPE_INFO_ABS - und SERVICE_TYPE_VALUE_ABS strukturen eine Ausnahme gemacht.

Hinweis

Der nspapi.h-Header definiert SERVICE_TYPE_VALUE_ABS als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht Codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Kopfzeile	nspapi.h

Weitere Informationen

SERVICE_INFO

SERVICE_TYPE_INFO_ABS

SetService