Freigeben über


SetServiceA-Funktion (nspapi.h)

Die SetService-Funktion registriert oder entfernt einen Netzwerkdienst in einem oder mehreren Namespaces aus der Registrierung. Die Funktion kann auch einen Netzwerkdiensttyp innerhalb eines oder mehrerer Namespaces hinzufügen oder entfernen.

Hinweis Die SetService-Funktion ist veraltet. Die unter Protokollunabhängige Namensauflösung beschriebenen Funktionen bieten entsprechende Funktionen in Windows Sockets 2. Für Entwickler von Windows Sockets 1.1 ist das Referenzmaterial wie folgt:
 

Syntax

INT SetServiceA(
  [in]           DWORD                dwNameSpace,
  [in]           DWORD                dwOperation,
  [in]           DWORD                dwFlags,
  [in]           LPSERVICE_INFOA      lpServiceInfo,
  [in, optional] LPSERVICE_ASYNC_INFO lpServiceAsyncInfo,
  [out]          LPDWORD              lpdwStatusFlags
);

Parameter

[in] dwNameSpace

Der Namespace oder eine Reihe von Standardnamespaces, in denen die Funktion ausgeführt wird.

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 Domain Name System, das im Internet verwendet wird, um den Namen des Hosts aufzulösen.
NS_NDS
Der NetWare 4-Anbieter.
NS_NETBT
Die NetBIOS-über TCP/IP-Ebene. Alle Windows-Systeme registrieren ihre Computernamen bei NetBIOS. Dieser Namespace wird verwendet, um einen Computernamen in eine IP-Adresse zu konvertieren, die diese Registrierung verwendet.
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\posts.
NS_TCPIP_LOCAL
Lokale TCP/IP-Namensauflösungsmechanismen, einschließlich Vergleichen mit dem lokalen Hostnamen und dem Suchwert im Cache von Host-zu-IP-Adresszuordnungen.

[in] dwOperation

Der Vorgang, den die Funktion ausführt. Verwenden Sie einen der folgenden Werte, um einen Vorgang anzugeben:

Wert Bedeutung
SERVICE_REGISTER
Registrieren Sie den Netzwerkdienst beim Namespace. Dieser Vorgang kann mit den SERVICE_FLAG_DEFER- und SERVICE_FLAG_HARD-Bitflags verwendet werden.
SERVICE_DEREGISTER
Entfernen Sie den Netzwerkdienst aus der Registrierung aus dem Namespace. Dieser Vorgang kann mit den SERVICE_FLAG_DEFER- und SERVICE_FLAG_HARD-Bitflags verwendet werden.
SERVICE_FLUSH
Führen Sie jeden Vorgang aus, der aufgerufen wurde, wobei das SERVICE_FLAG_DEFER Bitflag auf eins festgelegt ist.
SERVICE_ADD_TYPE
Fügen Sie dem Namespace einen Diensttyp hinzu.

Verwenden Sie für diesen Vorgang das ServiceSpecificInfo-Element der SERVICE_INFO-Struktur , auf die von lpServiceInfo verwiesen wird, um eine SERVICE_TYPE_INFO_ABS-Struktur zu übergeben. Sie müssen auch das ServiceType-Element der SERVICE_INFO-Struktur festlegen. Andere SERVICE_INFO-Member werden ignoriert.

SERVICE_DELETE_TYPE
Entfernen Sie einen Diensttyp, der durch einen vorherigen Aufruf hinzugefügt wurde, der den SERVICE_ADD_TYPE Vorgang angibt, aus dem Namespace.

[in] dwFlags

Eine Reihe von Bitflags, die den Vorgang der Funktion ändern. Sie können mindestens eins der folgenden Bitflags festlegen:

Wert Bedeutung
SERVICE_FLAG_DEFER
Dieses Bitflag ist nur gültig, wenn der Vorgang SERVICE_REGISTER oder SERVICE_DEREGISTER ist.

Wenn dieses Bitflag eins ist und gültig ist, sollte der Namespaceanbieter den Registrierungs- oder Deregistrierungsvorgang zurückstellen, bis ein SERVICE_FLUSH Vorgang angefordert wird.

SERVICE_FLAG_HARD
Dieses Bitflag ist nur gültig, wenn der Vorgang SERVICE_REGISTER oder SERVICE_DEREGISTER ist.

Wenn dieses Bitflag eins ist und gültig ist, aktualisiert der Namespaceanbieter alle relevanten persistenten Speicherinformationen, wenn der Vorgang ausgeführt wird.

Beispiel: Wenn der Vorgang die Deregistrierung in einem Namespace beinhaltet, der einen persistenten Speicher verwendet, entfernt der Namespaceanbieter die relevanten Informationen zum beständigen Speicher.

[in] lpServiceInfo

Ein Zeiger auf eine SERVICE_INFO-Struktur , die Informationen zum Netzwerkdienst oder Diensttyp enthält.

[in, optional] lpServiceAsyncInfo

Für die zukünftige Verwendung reserviert. Muss auf NULL festgelegt werden.

[out] lpdwStatusFlags

Eine Reihe von Bitflags, die Funktionen status Informationen empfangen. Das folgende Bitflag wird definiert:

Wert Bedeutung
SET_SERVICE_ PARTIAL_SUCCESS
Mindestens ein Namespaceanbieter konnte den angeforderten Vorgang nicht erfolgreich ausführen.

Rückgabewert

Wenn die Funktion fehlschlägt, wird der Rückgabewert SOCKET_ERROR. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf. GetLastError kann den folgenden erweiterten Fehlerwert zurückgeben.

Fehlercode Bedeutung
ERROR_ALREADY_ REGISTRIERT
Die Funktion hat versucht, einen bereits registrierten Dienst zu registrieren.

Hinweise

Hinweis

Der nspapi.h-Header definiert SetService 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]
Zielplattform Windows
Kopfzeile nspapi.h
Bibliothek Mswsock.lib
DLL Mswsock.dll

Weitere Informationen

GetService

SERVICE_INFO

SERVICE_TYPE_INFO_ABS

Winsock-Funktionen

Winsock-Referenz