NetWkstaUserGetInfo-Funktion (lmwksta.h)

Artikel
08/24/2023

Die NetWkstaUserGetInfo-Funktion gibt Informationen zum aktuell angemeldeten Benutzer zurück. Diese Funktion muss im Kontext des angemeldeten Benutzers aufgerufen werden.

Syntax

NET_API_STATUS NET_API_FUNCTION NetWkstaUserGetInfo(
        LMSTR  reserved,
  [in]  DWORD  level,
  [out] LPBYTE *bufptr
);

Parameter

reserved

Dieser Parameter muss auf NULL festgelegt werden.

[in] level

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

Wert	Bedeutung
0	Gibt den Namen des Benutzers zurück, der derzeit bei der Arbeitsstation angemeldet ist. Der bufptr-Parameter verweist auf eine WKSTA_USER_INFO_0 Struktur.
1	Gibt Informationen zur Arbeitsstation zurück, einschließlich des Namens des aktuellen Benutzers und der Domänen, auf die die Arbeitsstation zugreift. Der bufptr-Parameter verweist auf eine WKSTA_USER_INFO_1-Struktur .
1101	Gibt Domänen zurück, die von der Arbeitsstation durchsucht wurden. Der bufptr-Parameter verweist auf eine WKSTA_USER_INFO_1101 Struktur.

[out] bufptr

Zeiger auf den Puffer, der die Daten empfängt. Das Format dieser Daten hängt vom Wert des bufptr-Parameters ab. Dieser Puffer wird vom System zugewiesen und muss mithilfe der NetApiBufferFree-Funktion freigegeben werden. Weitere Informationen finden Sie unter Netzwerkverwaltungsfunktionspuffer und Netzwerkverwaltungsfunktionspufferlängen.

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_NOT_ENOUGH_MEMORY	Dem System gingen die Arbeitsspeicherressourcen aus. Entweder ist die Netzwerk-Manager-Konfiguration falsch, oder das Programm wird auf einem System mit unzureichendem Arbeitsspeicher ausgeführt.
ERROR_INVALID_LEVEL	Der Levelparameter ist ungültig.
ERROR_INVALID_PARAMETER	Einer der Funktionsparameter ist ungültig.

Hinweise

Die NetWkstaUserGetInfo-Funktion funktioniert nur lokal.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie Informationen zum aktuell angemeldeten Benutzer mithilfe eines Aufrufs der NetWkstaUserGetInfo-Funktion abgerufen werden. Im Beispiel wird NetWkstaUserGetInfo aufgerufen, wobei die Informationsebene 1 (WKSTA_USER_INFO_1) angegeben wird. Wenn der Aufruf erfolgreich ist, werden im Beispiel Informationen zum angemeldeten Benutzer ausgegeben. Schließlich gibt das Beispiel den für den Informationspuffer zugewiesenen Arbeitsspeicher frei.

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

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

int wmain(void)
{
   DWORD dwLevel = 1;
   LPWKSTA_USER_INFO_1 pBuf = NULL;
   NET_API_STATUS nStatus;
   //
   // Call the NetWkstaUserGetInfo function;
   //  specify level 1.
   //
   nStatus = NetWkstaUserGetInfo(NULL,
                                 dwLevel,
                                 (LPBYTE *)&pBuf);
   //
   // If the call succeeds, print the information
   //  about the logged-on user.
   //
   if (nStatus == NERR_Success)
   {
      if (pBuf != NULL)
      {
         wprintf(L"\n\tUser:          %s\n", pBuf->wkui1_username);
         wprintf(L"\tDomain:        %s\n", pBuf->wkui1_logon_domain);
         wprintf(L"\tOther Domains: %s\n", pBuf->wkui1_oth_domains);
         wprintf(L"\tLogon Server:  %s\n", pBuf->wkui1_logon_server);
      }
   }
   // Otherwise, print the system error.
   //
   else
      fprintf(stderr, "A system error has occurred: %d\n", nStatus);
   //
   // Free the allocated memory.
   //
   if (pBuf != NULL)
      NetApiBufferFree(pBuf);

   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