NetWkstaUserSetInfo-Funktion (lmwksta.h)

Artikel
08/24/2023

Die NetWkstaUserSetInfo-Funktion legt die benutzerspezifischen Informationen zu den Konfigurationselementen für eine Arbeitsstation fest.

Syntax

NET_API_STATUS NET_API_FUNCTION NetWkstaUserSetInfo(
        LMSTR   reserved,
  [in]  DWORD   level,
  [in]  LPBYTE  buf,
  [out] LPDWORD parm_err
);

Parameter

reserved

Dieser Parameter muss auf 0 festgelegt werden.

[in] level

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

Wert	Bedeutung
1	Gibt Informationen zur Arbeitsstation an, einschließlich des Namens des aktuellen Benutzers und der Domänen, auf die die Arbeitsstation zugreift. Der buf-Parameter verweist auf eine WKSTA_USER_INFO_1-Struktur .
1101	Gibt Domänen an, die von der Arbeitsstation durchsucht werden. Der buf-Parameter verweist auf eine WKSTA_USER_INFO_1101-Struktur .

[in] buf

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

[out] parm_err

Zeiger auf einen Wert, der den Index des ersten Parameters empfängt, der den ERROR_INVALID_PARAMETER Fehler verursacht. Wenn dieser Parameter NULL ist, wird der Index nicht bei einem Fehler zurückgegeben.

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.

Rückgabecode	Beschreibung
ERROR_INVALID_LEVEL	Der Levelparameter ist ungültig.
ERROR_INVALID_PARAMETER	Einer der Funktionsparameter ist ungültig.

Hinweise

Die NetWkstaUserSetInfo-Funktion funktioniert nur lokal. Administratorgruppenmitgliedschaft ist erforderlich.

Domänennamen im wkui1101_oth_domains Member der WKSTA_USER_INFO_1101-Struktur sind durch Leerzeichen getrennt. Eine leere Liste ist gültig. Ein NULL-Zeiger bedeutet, dass das Element unverändert bleibt. Das wkui1101_oth_domains-Member kann nicht mit MS-DOS festgelegt werden. Beim Festlegen dieses Elements lehnt NetWkstaUserSetInfo die Anforderung ab, wenn die Namensliste ungültig war oder wenn einem oder mehreren vom System verwalteten Netzwerkadaptern kein Name hinzugefügt werden konnte.

Wenn die NetWkstaUserSetInfo-Funktion ERROR_INVALID_PARAMETER zurückgibt, können Sie den parameter parm_err verwenden, um den ungültigen Member der Benutzerinformationsstruktur der Arbeitsstation anzugeben. (Eine Arbeitsstationsbenutzerinformationsstruktur beginnt mit WKSTA_USER_INFO_, und ihr Format wird durch den Levelparameter angegeben.) Die folgende Tabelle enthält den Wert, der im parm_err-Parameter zurückgegeben werden kann, und den entsprechenden Strukturmember, der fehlerhaft ist. (Das Präfix wkui*_ gibt an, dass das Element mit mehreren Präfixen beginnen kann, z. B. wkui0_ oder wkui1_.)

Wert	Member
WKSTA_OTH_DOMAINS_PARMNUM	wkui*_oth_domains

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie benutzerspezifische Informationen für eine Arbeitsstation mithilfe eines Aufrufs der NetWkstaUserSetInfo-Funktion festgelegt werden, wobei die Informationsebene 1101 ( WKSTA_USER_INFO_1101) angegeben wird.

#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 = 1101;
   WKSTA_USER_INFO_1101 wui;
   NET_API_STATUS nStatus;

   if (argc != 2)
   {
      fwprintf(stderr, L"Usage: %s OtherDomains\n", argv[0]);
      exit(1);
   }
   //
   // Fill in the WKSTA_USER_INFO_1101 structure member.
   //
   wui.wkui1101_oth_domains = argv[1];
   //
   // Call the NetWkstaUserSetInfo function
   //  to change the list of domains browsed by
   //  the workstation; specify level 1101.
   //
   nStatus = NetWkstaUserSetInfo(NULL,
                                 dwLevel,
                                 (LPBYTE)&wui,
                                 NULL);
   //
   // Display the result of the call.
   //
   if (nStatus == NERR_Success)
      fprintf(stderr, "Workstation user information has been changed\n");
   else
      fprintf(stderr, "A system error has occurred: %d\n", nStatus);

   return 0;
}

Anforderungen


Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	lmwksta.h (lm.h einschließen)
Bibliothek	Netapi32.lib
DLL	Netapi32.dll