NetServerSetInfo-Funktion (lmserver.h)

Die NetServerSetInfo-Funktion legt die Betriebsparameter eines Servers fest. sie kann sie einzeln oder gemeinsam festlegen. Die Informationen werden so gespeichert, dass sie nach der erneuten Initialisierung des Systems wirksam bleiben können.

Syntax

NET_API_STATUS NET_API_FUNCTION NetServerSetInfo(
  [in]  LMSTR   servername,
  [in]  DWORD   level,
  [in]  LPBYTE  buf,
  [out] LPDWORD ParmError
);

Parameter

[in] servername

Zeiger auf eine Zeichenfolge, die den Namen des Remoteservers angibt, auf dem die Funktion ausgeführt werden soll. Wenn dieser Parameter NULL ist, wird der lokale Computer verwendet.

[in] level

Gibt die Informationsebene der Daten an. Dieser Parameter kann einen der folgenden Werte annehmen.

Darüber hinaus gelten die Stufen 1001-1006, 1009-1011, 1016-1018, 1021, 1022, 1028, 1029, 1037 und 1043 basierend auf den Einschränkungen für LAN Manager-Systeme.

[in] buf

Zeiger auf einen Puffer, der die Serverinformationen empfängt. Das Format dieser Daten hängt vom Wert des Ebenenparameters ab. Weitere Informationen finden Sie unter Netzwerkverwaltungsfunktionspuffer.

[out] ParmError

Zeiger auf einen Wert, der den Index des ersten Members der Serverinformationsstruktur empfängt, der den ERROR_INVALID_PARAMETER Fehler verursacht. Wenn dieser Parameter NULL ist, wird der Index nicht bei einem Fehler zurückgegeben. Weitere Informationen finden Sie im folgenden Abschnitt "Hinweise".

Rückgabewert

Wenn die Funktion erfolgreich ist, wird der Rückgabewert NERR_Success.

Wenn die Funktion fehlschlägt, kann der Rückgabewert einer der folgenden Fehlercodes sein.

Hinweise

Nur Mitglieder der lokalen Gruppe Administratoren oder Serveroperatoren können die NetServerSetInfo-Funktion erfolgreich ausführen.

Wenn Sie für Active Directory programmieren, können Sie möglicherweise bestimmte ADSI-Methoden (Active Directory Service Interface) aufrufen, um dieselbe Funktionalität zu erzielen, die Sie durch aufrufen der Netzwerkverwaltungsserverfunktionen erreichen können. Weitere Informationen finden Sie unter IADsComputer.

Wenn die NetServerSetInfo-Funktion ERROR_INVALID_PARAMETER zurückgibt, können Sie den ParmError-Parameter verwenden, um das erste element der Serverinformationsstruktur anzugeben, das ungültig ist. (Eine Serverinformationsstruktur beginnt mit SERVER_INFO_, und ihr Format wird durch den Levelparameter angegeben.) In der folgenden Tabelle sind die Werte aufgeführt, die im ParmError-Parameter zurückgegeben werden können, und dem entsprechenden Strukturmember, der fehlerhaft ist. (Das Präfix sv*_ gibt an, dass das Element mit mehreren Präfixen beginnen kann, z. B. sv101_ oder sv402_.)

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie die NetServerSetInfo-Funktion aufgerufen wird. Im Beispiel wird NetServerSetInfo aufgerufen, wobei der level-Parameter als 1005 (erforderlich) angegeben wird, um den sv1005_comment-Member der SERVER_INFO_1005-Struktur festzulegen.

#ifndef UNICODE
#define UNICODE
#endif
#pragma comment(lib, "netapi32.lib")

#include <stdio.h>
#include <windows.h> 
#include <lm.h>

int wmain(int argc, wchar_t *argv[])
{
   DWORD dwLevel = 1005;
   SERVER_INFO_1005 si;
   NET_API_STATUS nStatus;

   if (argc != 3)
   {
      fwprintf(stderr, L"Usage: %s \\\\ServerName Comment\n", argv[0]);
      exit(1);
   }
   //
   // Fill in SERVER_INFO_1005 structure member.
   //
   si.sv1005_comment = (LPTSTR) argv[2];
   //
   // Call the NetServerSetInfo function, 
   //  specifying level 1005.
   //
   nStatus = NetServerSetInfo(argv[1],
                              dwLevel,
                              (LPBYTE)&si,
                              NULL);
   //
   // Display the result of the call.
   //
   if (nStatus == NERR_Success)
      fwprintf(stderr, L"Comment reset\n", argv[2]);
   else
      fprintf(stderr, "A system error has occurred: %d\n", nStatus);
   return 0;
}

Anforderungen

Weitere Informationen

NetServerGetInfo

Netzwerkverwaltungsfunktionen

Übersicht über die Netzwerkverwaltung

SERVER_INFO_101

SERVER_INFO_102

SERVER_INFO_402

SERVER_INFO_403

Serverfunktionen