SERVICE_INFOA-Struktur (nspapi.h)

Artikel
08/25/2023

Die SERVICE_INFO-Struktur enthält Informationen zu einem Netzwerkdienst oder 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;

Member

lpServiceType

Typ: LPGUID

Ein Zeiger auf eine GUID, die dem Typ des Netzwerkdiensts entspricht.

lpServiceName

Typ: LPTSTR

Ein Zeiger auf eine NULL-beendete Zeichenfolge, die dem Namen des Netzwerkdiensts entspricht.

Wenn Sie die SetService-Funktion aufrufen, wobei der dwNameSpace-Parameter auf NS_DEFAULT festgelegt ist, muss der Name des Netzwerkdiensts ein allgemeiner Name sein. Der Netzwerkdienst wird allgemein als Name bezeichnet. Ein Beispiel für einen allgemeinen Namen für einen Netzwerkdienst ist "My SQL Server".

Wenn Sie die SetService-Funktion aufrufen, wobei der dwNameSpace-Parameter auf einen bestimmten Dienstnamen festgelegt ist, kann der Name des Netzwerkdiensts ein allgemeiner Name oder ein distinguished Name sein. Ein distinguished Name unterscheidet den Dienst an einem eindeutigen Speicherort mit einem Verzeichnisdienst. Ein Beispiel für einen distinguished Name für einen Netzwerkdienst ist "MS\SYS\NT\DEV\My SQL Server".

lpComment

Typ: LPTSTR

Ein Zeiger auf eine NULL-beendete Zeichenfolge, die ein Kommentar oder eine Beschreibung für den Netzwerkdienst ist. Beispiel: "Wird für Entwicklungsupgrades verwendet."

lpLocale

Typ: LPTSTR

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

dwDisplayHint

Art: DWORD

Ein Hinweis zum Anzeigen des Netzwerkdiensts in einer Benutzeroberfläche für das Browsen im Netzwerk. 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 Zum Anzeigen des Objekts verwendete Methode spielt keine Rolle.
RESOURCEDISPLAYTYPE_GROUP	Zeigen Sie den Netzwerkdienst als Gruppe an.
RESOURCEDISPLAYTYPE_SERVER	Zeigen Sie den Netzwerkdienst als Server an.
RESOURCEDISPLAYTYPE_SHARE	Zeigt den Netzwerkdienst als Sharepoint an.
RESOURCEDISPLAYTYPE_TREE	Zeigt den Netzwerkdienst als Struktur an.

dwVersion

Art: 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

Art: DWORD

Für die zukünftige Verwendung reserviert. Muss Null sein.

lpMachineName

Typ: LPTSTR

Ein Zeiger auf eine NULL-endende 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 die getockname-Funktion aufrufen, um die lokale Adresse des Systems zu bestimmen.

ServiceSpecificInfo

Typ: BLOB

Eine BLOB-Struktur , die vom Dienst definierte Informationen angibt.

Hinweis Im Allgemeinen dürfen die Daten, auf die der pBlobData-Member der BLOB-Struktur verweist, 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 Zeigerinvalidierung führen. Wenn die Daten, auf die von pBlobData verwiesen wird, Elemente mit variabler Größe enthalten, können Offsets aus pBlobData verwendet werden, um die Position dieser Elemente anzugeben. Es gibt eine Ausnahme von dieser allgemeinen Regel: wenn pBlobData auf eine SERVICE_TYPE_INFO_ABS-Struktur zeigt. 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 daher deren Formate dem Betriebssystem bekannt sind.

Hinweise

Hinweis

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
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Kopfzeile	nspapi.h