NetGetJoinInformation-Funktion (lmjoin.h)

  • Artikel

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