NetGetJoinInformation, fonction (lmjoin.h)

Article
08/24/2023

La fonction NetGetJoinInformation récupère les informations de jointure status pour l’ordinateur spécifié.

Syntaxe

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

Paramètres

[in] lpServer

Pointeur vers une chaîne constante qui spécifie le nom DNS ou NetBIOS de l’ordinateur sur lequel appeler la fonction. Si ce paramètre a la valeur NULL, l’ordinateur local est utilisé.

[out] lpNameBuffer

Pointeur vers la mémoire tampon qui reçoit le nom NetBIOS du domaine ou du groupe de travail auquel l’ordinateur est joint. Cette mémoire tampon est allouée par le système et doit être libérée à l’aide de la fonction NetApiBufferFree . Pour plus d’informations, consultez Mémoires tampons de fonction de gestion réseau et Longueurs de mémoire tampon des fonctions de gestion réseau.

[out] BufferType

Reçoit le status de jointure de l’ordinateur spécifié. Ce paramètre peut avoir l’une des valeurs suivantes.

typedef enum _NETSETUP_JOIN_STATUS {

    NetSetupUnknownStatus = 0,
    NetSetupUnjoined,
    NetSetupWorkgroupName,
    NetSetupDomainName

} NETSETUP_JOIN_STATUS, *PNETSETUP_JOIN_STATUS;

Ces valeurs ont les significations suivantes.

Valeur	Signification
NetSetupUnknownStatus	Le status est inconnu.
NetSetupUnjoined	L’ordinateur n’est pas joint.
NetSetupWorkgroupName	L’ordinateur est joint à un groupe de travail.
NetSetupDomainName	L’ordinateur est joint à un domaine.

Valeur retournée

Si la fonction réussit, la valeur de retour est NERR_Success.

Si la fonction échoue, la valeur de retour peut être le code d’erreur suivant ou l’un des codes d’erreur système.

Code de retour	Description
ERROR_NOT_ENOUGH_MEMORY	Le stockage disponible est insuffisant pour traiter cette commande.

Notes

Aucune appartenance à un groupe spécial n’est requise pour exécuter correctement la fonction NetGetJoinInformation .

Configuration requise


Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	lmjoin.h (include Lm.h)
Bibliothèque	Netapi32.lib
DLL	Netapi32.dll; Wkscli.dll

Voir aussi

NetGetJoinableOUs

Fonctions de gestion réseau

Vue d’ensemble de la gestion du réseau