NetRemoteComputerSupports, fonction (lmremutl.h)

  • Article

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