Partager via

ConnectServerWmi, fonction

  • Article

Crée une connexion via DCOM à un espace de noms WMI sur un ordinateur spécifié.

Notes

Cette API est destinée à un usage interne uniquement. Elle n’est pas destinée à être utilisée dans le code du développeur.

Syntaxe

HRESULT ConnectServerWmi (
   [in] BSTR               strNetworkResource,
   [in] BSTR               strUser,
   [in] BSTR               strPassword,
   [in] BSTR               strLocale,
   [in] long               lSecurityFlags,
   [in] BSTR               strAuthority,
   [in] IWbemContext*      pCtx,
   [out] IWbemServices**   ppNamespace,
   [in] DWORD              impLevel,
   [in] DWORD              authLevel
);

Paramètres

strNetworkResource
[in] Pointeur vers un BSTR valide qui contient le chemin d’accès d’objet de l’espace de noms WMI correct. Pour plus d'informations, consultez la section Remarques.

strUser
[in] Pointeur vers un BSTR valide qui contient le nom d’utilisateur. Une valeur null indique le contexte de sécurité actuel. Si l’utilisateur provient d’un domaine différent de celui actuel, strUser peut également contenir le domaine et le nom d’utilisateur séparés par une barre oblique inverse. strUser peut également être au format UPN (User Principal Name), par exemple userName@domainName. Pour plus d'informations, consultez la section Remarques.

strPassword
[in] Pointeur vers un BSTR valide qui contient le mot de passe. Un null indique le contexte de sécurité actuel. Une chaîne vide («  ») indique un mot de passe de longueur zéro valide.

strLocale
[in] Pointeur vers un BSTR valide qui indique les paramètres régionaux appropriés pour la récupération d’informations. Pour les identificateurs de paramètres régionaux Microsoft, le format de la chaîne est « MS_xxx », où xxx est une chaîne sous forme hexadécimale qui indique l’identificateur de paramètres régionaux (LCID). Si des paramètres régionaux non valides sont spécifiés, la méthode retourne WBEM_E_INVALID_PARAMETER à l’exception de Windows 7, où les paramètres régionaux par défaut du serveur sont utilisés à la place. Si `null1, les paramètres régionaux actuels sont utilisés.

lSecurityFlags
[in] Indicateurs à passer à la méthode ConnectServerWmi. Une valeur de zéro (0) pour ce paramètre entraîne le retour de l’appel à ConnectServerWmi uniquement après l’établissement d’une connexion au serveur. Cela pourrait avoir pour conséquence qu'une application ne réponde pas indéfiniment si le serveur est en panne. Les autres valeurs valides sont :

Constant Valeur Description
CONNECT_REPOSITORY_ONLY 0x40 Réservé à un usage interne. Ne pas utiliser.
WBEM_FLAG_CONNECT_USE_MAX_WAIT 0x80 ConnectServerWmi retourne en deux minutes ou moins.

strAuthority
[in] Nom de domaine de l’utilisateur. Il peut avoir les valeurs suivantes :

Valeur Description
blank L’authentification NTLM est utilisée et le domaine NTLM de l’utilisateur actuel est utilisé. Si strUser spécifie le domaine (emplacement recommandé), il ne doit pas être spécifié ici. La fonction retourne WBEM_E_INVALID_PARAMETER si vous spécifiez le domaine dans les deux paramètres.
Kerberos :nom de principal L’authentification Kerberos est utilisée et ce paramètre contient un nom de principal Kerberos.
NTLMDOMAIN :nom de domaine L’authentification NT LAN Manager est utilisée et ce paramètre contient un nom de domaine NTLM.

pCtx
[in] En général, ce paramètre est null. Sinon, il s’agit d’un pointeur vers un objet IWbemContext requis par un ou plusieurs fournisseurs de classes dynamiques.

ppNamespace
[out] Lorsque la fonction retourne, reçoit un pointeur vers un objet IWbemServices lié à l’espace de noms spécifié. Il est défini pour pointer vers null lorsqu’il y a une erreur.

impLevel
[in] Niveau d'emprunt d'identité.

authLevel
[in] Niveau d’autorisation.

Valeur retournée

Les valeurs suivantes renvoyées par cette fonction sont définies dans le fichier d’en-tête WbemCli.h, ou vous pouvez les définir comme constantes dans votre code :

Constant Valeur Description
WBEM_E_FAILED 0x80041001 Il y a eu une défaillance générale.
WBEM_E_INVALID_PARAMETER 0x80041008 Un paramètre n'est pas valide.
WBEM_E_OUT_OF_MEMORY 0x80041006 La mémoire n'est pas suffisante pour terminer cette opération.
WBEM_S_NO_ERROR 0 L’appel de fonction a abouti.

Notes

Cette fonction encapsule un appel à la méthode IWbemLocator::ConnectServer.

Pour l’accès local à l’espace de noms par défaut, strNetworkResource peut être un chemin d’accès d’objet simple : « root\default » ou « \.\root\default ». Pour accéder à l’espace de noms par défaut sur un ordinateur distant à l’aide d’une mise en réseau compatible COM ou Microsoft, incluez le nom de l’ordinateur : « \myserver\root\default ». Le nom de l’ordinateur peut également être un nom DNS ou une adresse IP. La fonction ConnectServerWmi peut également se connecter à des ordinateurs exécutant IPv6 à l’aide d’une adresse IPv6.

strUser ne peut pas être une chaîne vide. Si le domaine est spécifié dans strAuthority, il ne doit pas également être inclus dans strUser, ou la fonction retourne WBEM_E_INVALID_PARAMETER.

Spécifications

Plateformes : Consultez Configuration requise.

En-tête : WMINet_Utils.idl

Versions de .NET Framework : disponibles depuis la version 4.7.2

Voir aussi