Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
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 |
|---|---|
|
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. |
|
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 . |
|
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 |
|---|---|
|
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. |
|
Der Levelparameter ist ungültig. |
|
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 |
Weitere Informationen
Übersicht über die Netzwerkverwaltung
Benutzerfunktionen für Arbeitsstationen und Arbeitsstationen