SERVICE_INFOA Struktur (nspapi.h)

Artikel
11/20/2024

Die SERVICE_INFO-Struktur enthält Informationen zu einem Netzwerkdienst oder einem Netzwerkdiensttyp.

Syntax

typedef struct _SERVICE_INFOA {
  LPGUID              lpServiceType;
  LPSTR               lpServiceName;
  LPSTR               lpComment;
  LPSTR               lpLocale;
  DWORD               dwDisplayHint;
  DWORD               dwVersion;
  DWORD               dwTime;
  LPSTR               lpMachineName;
  LPSERVICE_ADDRESSES lpServiceAddress;
  BLOB                ServiceSpecificInfo;
} SERVICE_INFOA, *PSERVICE_INFOA, *LPSERVICE_INFOA;

Angehörige

lpServiceType

Typ: LPGUID-

Ein Zeiger auf eine GUID, die den Typ des Netzwerkdiensts darstellt.

lpServiceName

Typ: LPTSTR-

Ein Zeiger auf eine NULL--terminated string that is the name of the network service.

Wenn Sie die SetService--Funktion aufrufen, wobei der dwNameSpace-Parameter auf NS_DEFAULT festgelegt ist, muss der Netzwerkdienstname ein allgemeiner Name sein. Ein allgemeiner Name ist das, was der Netzwerkdienst allgemein bekannt ist. Ein Beispiel für einen allgemeinen Namen für einen Netzwerkdienst ist "My SQL Server".

Wenn Sie die SetService--Funktion aufrufen, wobei der parameter dwNameSpace auf einen bestimmten Dienstnamen festgelegt ist, kann der Netzwerkdienstname ein allgemeiner name oder ein distinguished name sein. Ein distinguished name distinguishes the service distinguishes to a unique location with a directory service. Ein Beispiel für einen distinguished Name für einen Netzwerkdienst lautet "MS\SYS\NT\DEV\My SQL Server".

lpComment

Typ: LPTSTR-

Ein Zeiger auf eine NULL--terminated-Zeichenfolge, bei der es sich um einen Kommentar oder eine Beschreibung für den Netzwerkdienst handelt. Beispiel: "Wird für Entwicklungsupgrades verwendet".

lpLocale

Typ: LPTSTR-

Ein Zeiger auf eine NULL--terminated-Zeichenfolge, die Gebietsschemainformationen enthält.

dwDisplayHint

Typ: DWORD-

Ein Hinweis zum Anzeigen des Netzwerkdiensts in einer Netzwerkbrowsen-Benutzeroberfläche. Dies kann einer der folgenden Werte sein:

Wert	Bedeutung
RESOURCEDISPLAYTYPE_DOMAIN	Zeigt den Netzwerkdienst als Domäne an.
RESOURCEDISPLAYTYPE_FILE	Zeigt den Netzwerkdienst als Datei an.
RESOURCEDISPLAYTYPE_GENERIC	Die Methode, die zum Anzeigen des Objekts verwendet wird, spielt keine Rolle.
RESOURCEDISPLAYTYPE_GROUP	Zeigt den Netzwerkdienst als Gruppe an.
RESOURCEDISPLAYTYPE_SERVER	Zeigt den Netzwerkdienst als Server an.
RESOURCEDISPLAYTYPE_SHARE	Zeigen Sie den Netzwerkdienst als SharePoint an.
RESOURCEDISPLAYTYPE_TREE	Zeigt den Netzwerkdienst als Struktur an.

dwVersion

Typ: DWORD-

Die Version für den Netzwerkdienst. Das hohe Wort dieses Werts gibt eine Hauptversionsnummer an. Das niedrige Wort dieses Werts gibt eine Nebenversionsnummer an.

dwTime

Typ: DWORD-

Reserviert für die zukünftige Verwendung. Muss null sein.

lpMachineName

Typ: LPTSTR-

Ein Zeiger auf eine NULL--terminated-Zeichenfolge, die den Namen des Computers darstellt, auf dem der Netzwerkdienst ausgeführt wird.

lpServiceAddress

Typ: LPSERVICE_ADDRESSES

Ein Zeiger auf eine SERVICE_ADDRESSES Struktur, die ein Array von SERVICE_ADDRESS Strukturen enthält. Jede SERVICE_ADDRESS Struktur enthält Informationen zu einer Netzwerkdienstadresse.

Ein Netzwerkdienst kann den getsockname Funktion aufrufen, um die lokale Adresse des Systems zu ermitteln.

ServiceSpecificInfo

Typ: BLOB-

Eine BLOB- Struktur, die dienstdefinierte Informationen angibt.

Hinweis Im Allgemeinen dürfen die daten, auf die durch das BLOB Struktur pBlobData Member verwiesen wird, keine Zeiger enthalten. Das liegt daran, dass nur der Netzwerkdienst das Format der Daten kennt; Das Kopieren der Daten ohne solche Kenntnisse würde zu einer Zeigerinvaligierung führen. Wenn die daten, auf die von pBlobData verweisen, Elemente mit variabler Größe enthalten, können Offsets aus pBlobData- verwendet werden, um die Position dieser Elemente anzugeben. Es gibt eine Ausnahme dieser allgemeinen Regel: Wenn pBlobData- auf eine SERVICE_TYPE_INFO_ABS Struktur verweist. Dies ist möglich, da sowohl die SERVICE_TYPE_INFO_ABS-Struktur als auch alle darin enthaltenen SERVICE_TYPE_VALUE_ABS Strukturen vordefiniert sind und somit ihre Formate dem Betriebssystem bekannt sind.

Bemerkungen

Anmerkung

Der nspapi.h-Header definiert SERVICE_INFO 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
mindestens unterstützte Client-	Windows 2000 Professional [nur Desktop-Apps]
mindestens unterstützte Server-	Windows 2000 Server [nur Desktop-Apps]
Header-	nspapi.h