NetRemoteComputerSupports, fonction (lmremutl.h)

Article
03/01/2024

La fonction NetRemoteComputerSupports interroge le redirecteur pour récupérer les fonctionnalités facultatives prises en charge par le système distant. Les fonctionnalités incluent Unicode, l’appel de procédure distante (RPC) et la prise en charge du protocole d’administration à distance. La fonction établit une connexion réseau si elle n’en existe pas.

Syntaxe

NET_API_STATUS NET_API_FUNCTION NetRemoteComputerSupports(
  [in]  LPCWSTR UncServerName,
  [in]  DWORD   OptionsWanted,
  [out] LPDWORD OptionsSupported
);

Paramètres

[in] UncServerName

Pointeur vers une chaîne constante qui spécifie le nom du serveur distant à interroger. Si ce paramètre a la valeur NULL, l’ordinateur local est utilisé.

[in] OptionsWanted

Spécifie une valeur qui contient un ensemble d’indicateurs de bits indiquant les fonctionnalités intéressantes. Ce paramètre doit être au moins l’une des valeurs suivantes.

Valeur	Signification
SUPPORTS_REMOTE_ADMIN_PROTOCOL	Demande la prise en charge du protocole d’administration à distance.
SUPPORTS_RPC	Demande la prise en charge rpc.
SUPPORTS_SAM_PROTOCOL	Demande la prise en charge du Gestionnaire de compte de sécurité (SAM).
SUPPORTS_UNICODE	Demande la prise en charge standard Unicode.
SUPPORTS_LOCAL	Demande la prise en charge des trois premières valeurs répertoriées dans ce tableau. Si UNICODE est défini par l’application appelante, demande les quatre fonctionnalités répertoriées précédemment.

[out] OptionsSupported

Pointeur vers une valeur qui reçoit un ensemble d’indicateurs de bits. Les indicateurs indiquent les fonctionnalités spécifiées par le paramètre OptionsWanted qui sont implémentées sur l’ordinateur spécifié par le paramètre UncServerName . (Tous les autres bits sont définis sur zéro.)

La valeur de ce paramètre est valide uniquement lorsque la fonction NetRemoteComputerSupports retourne NERR_Success.

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 l’un des codes d’erreur suivants.

Code de retour	Description
ERROR_INVALID_PARAMETER	Le paramètre OptionsWanted ou Le paramètre OptionsSupported a la valeur NULL ; les deux paramètres sont obligatoires.
ERROR_NOT_ENOUGH_MEMORY	La mémoire disponible est insuffisante.

Remarques

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

Configuration requise

Condition requise	Valeur
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	lmremutl.h (inclure Lm.h)
Bibliothèque	Netapi32.lib
DLL	Netapi32.dll

Voir aussi

NetServerGetInfo

Fonctions de gestion réseau

Vue d’ensemble de la gestion du réseau

Fonctions utilitaires distantes

Partager via