NetGetJoinInformation-Funktion (lmjoin.h)

Artikel
08/24/2023

Die NetGetJoinInformation-Funktion ruft join-status Informationen für den angegebenen Computer ab.

Syntax

NET_API_STATUS NET_API_FUNCTION NetGetJoinInformation(
  [in]  LPCWSTR               lpServer,
  [out] LPWSTR                *lpNameBuffer,
  [out] PNETSETUP_JOIN_STATUS BufferType
);

Parameter

[in] lpServer

Zeiger auf eine konstante Zeichenfolge, die den DNS- oder NetBIOS-Namen des Computers angibt, auf dem die Funktion aufgerufen werden soll. Wenn dieser Parameter NULL ist, wird der lokale Computer verwendet.

[out] lpNameBuffer

Zeiger auf den Puffer, der den NetBIOS-Namen der Domäne oder Arbeitsgruppe empfängt, in die der Computer eingebunden ist. Dieser Puffer wird vom System zugewiesen und muss mithilfe der NetApiBufferFree-Funktion freigegeben werden. Weitere Informationen finden Sie unter Netzwerkverwaltungsfunktionspuffer und Netzwerkverwaltungsfunktionspufferlängen.

[out] BufferType

Empfängt die Join-status des angegebenen Computers. Dieser Parameter kann einen der folgenden Werte aufweisen.

typedef enum _NETSETUP_JOIN_STATUS {

    NetSetupUnknownStatus = 0,
    NetSetupUnjoined,
    NetSetupWorkgroupName,
    NetSetupDomainName

} NETSETUP_JOIN_STATUS, *PNETSETUP_JOIN_STATUS;

Diese Werte haben die folgende Bedeutung.

Wert	Bedeutung
NetSetupUnknownStatus	Die status ist unbekannt.
NetSetupUnjoined	Der Computer ist nicht eingebunden.
NetSetupWorkgroupName	Der Computer ist einer Arbeitsgruppe zugeordnet.
NetSetupDomainName	Der Computer ist einer Domäne zugeordnet.

Rückgabewert

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

Wenn die Funktion fehlschlägt, kann der Rückgabewert der folgende Fehlercode oder einer der Systemfehlercodes sein.

Rückgabecode	Beschreibung
ERROR_NOT_ENOUGH_MEMORY	Für die Verarbeitung dieses Befehls steht nicht genügend Speicherplatz zur Verfügung.

Hinweise

Es ist keine spezielle Gruppenmitgliedschaft erforderlich, um die NetGetJoinInformation-Funktion erfolgreich auszuführen.

Anforderungen


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

Weitere Informationen

NetGetJoinableOUs

Netzwerkverwaltungsfunktionen

Übersicht über die Netzwerkverwaltung

Freigeben über