OpenNtmsSessionW, fonction (ntmsapi.h)

Article
11/20/2024

[Gestionnaire de stockage amovible n’est plus disponible depuis Windows 7 et Windows Server 2008 R2.]

La fonction OpenNtmsSession configure une session avec un serveur RSM.

Syntaxe

HANDLE OpenNtmsSessionW(
  [in] LPCWSTR lpServer,
  [in] LPCWSTR lpApplication,
       DWORD   dwOptions
);

Paramètres

[in] lpServer

Nom du serveur RSM. Si ce paramètre est NULL, le nom de l’ordinateur actuel est utilisé.

[in] lpApplication

Chaîne de caractères unique qui identifie l’application. Ce nom identifie les ressources et les demandes d’opérateur. Ce paramètre est facultatif et peut être NULL.

dwOptions

Réservé; doit être égal à zéro.

Valeur de retour

Si OpenNtmsSession réussit, il retourne un handle qui identifie de façon unique cette session. Si la fonction échoue, elle retourne INVALID_HANDLE_VALUE. Pour récupérer plus d’informations, appelez la fonction GetLastError. Cette fonction peut retourner l’une des valeurs suivantes.

Valeur	Signification
ERROR_INVALID_COMPUTERNAME	Le format de nom d’ordinateur spécifié n’était pas dans un format valide.
ERROR_INVALID_PARAMETER	L’une des valeurs de paramètre n’était pas valide.
ERROR_NO_NETWORK	Le réseau n’est pas démarré ou n’est pas disponible.
ERROR_NOT_CONNECTED	Impossible de se connecter au service RSM.
ERROR_NOT_READY	Le service RSM n’a pas démarré. L’application doit attendre et réessayer.
ERROR_SUCCESS	La fonction a réussi.
INVALID_HANDLE_VALUE	RSM ne peut pas ouvrir une session.
RPC_S_NO_INTERFACES	Le service utilise une version antérieure de RSM que votre application.

Remarques

La fonction OpenNtmsSession retourne un handle de session utilisé avec d’autres fonctions RSM, établit une connexion avec la base de données RSM et initialise le sous-système RSM pour l’application.

Lorsque openNtmsSession retourne, l’application peut effectuer des opérations RSM.

Les sessions sont thread-safe, mais ne peuvent pas être passées entre les processus.

Note

L’en-tête ntmsapi.h définit OpenNtmsSession comme alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. Le mélange de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows XP [applications de bureau uniquement]
serveur minimum pris en charge	Windows Server 2003 [applications de bureau uniquement]
plateforme cible	Windows
d’en-tête	ntmsapi.h
bibliothèque	Ntmsapi.lib
DLL	Ntmsapi.dll

Voir aussi

CloseNtmsSession

fonctions de gestion de session

Partager via