SERVICE_TYPE_VALUE_ABSA-Struktur (nspapi.h)

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

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;

Member

dwNameSpace

Art: DWORD

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

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

Wert	Bedeutung
NS_DEFAULT	Eine Reihe von Standardnamespaces. Die Funktion fragt jeden Namespace in diesem Satz ab. Der Satz von Standardnamespaces umfasst in der Regel alle Namespaces, die auf dem System installiert sind. Systemadministratoren können jedoch bestimmte Namespaces aus der Gruppe 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-über TCP/IP-Ebene. 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 möglicherweise auf einen WINS-Server zugreifen, um die Auflösung auszuführen.
NS_SAP	Das NetWare Service Advertising Protocol. Dies kann ggf. auf die NetWare-Binderie 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 Vergleiche 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 das lpValue-Element verweist. Bei REG_SZ und REG_MULTI_SZ Zeichenfolgendaten werden die Abschlusszeichen als Teil der Größe gezählt.

lpValueName

Typ: LPTSTR

Ein Zeiger auf eine NULL-beendete Zeichenfolge, die der Name des Werts ist. Dieser Name ist spezifisch für einen Namespace.

Mehrere häufig verwendete Wertnamenzeichenfolgen sind definierten Konstanten zugeordnet. Diese Namenszeichenfolgen umfassen 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 zum Hinzufügen eines Netzwerkdiensttyps zu einem Namespace verwenden, 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 eine Ausnahme für die SERVICE_TYPE_INFO_ABS - und SERVICE_TYPE_VALUE_ABS-Strukturen vorgenommen.

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 nicht codierungsneutralem Code 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