Fonction SetNtmsUIOptionsW (ntmsapi.h)
[Le Gestionnaire de stockage amovible n’est plus disponible à partir de Windows 7 et Windows Server 2008 R2.]
La fonction SetNtmsUIOptions modifie la liste des noms d’ordinateurs vers lesquels le type d’interface utilisateur spécifié est dirigé pour l’objet donné.
Syntaxe
DWORD SetNtmsUIOptionsW(
[in] HANDLE hSession,
[in] const LPNTMS_GUID lpObjectId,
[in] DWORD dwType,
[in] DWORD dwOperation,
[out] LPCWSTR lpszDestination
);
Paramètres
[in] hSession
Gérez la session retournée par la fonction OpenNtmsSession .
[in] lpObjectId
Identificateur unique de l’objet dont l’interface utilisateur est redirigée. L’objet doit être un conteneur qui peut être une source d’événements. L’objet peut être une application (une demande de montage déclenchée par l’application), une bibliothèque (une demande d’ouverture de porte en réponse à un éjection) ou un ordinateur (toute l’interface utilisateur relative à l’ordinateur).
Pour spécifier le conteneur d’ordinateur, définissez le pointeur lpObjectId pour qu’il pointe vers une mémoire tampon avec le GUID de l’objet ordinateur du Gestionnaire de stockage amovible. Pour spécifier une bibliothèque particulière, définissez-la pour qu’elle pointe vers une mémoire tampon avec le GUID de la bibliothèque. Pour spécifier une application, transmettez un pointeur NULL . L’identité de l’application est déterminée par la session utilisée dans hSession. Notez qu’une application peut avoir plusieurs sessions ouvertes simultanément. Dans ce cas, le jeu de valeurs s’applique uniquement à la session hSession . Dans le cas d’une bibliothèque ou d’un ordinateur instance, les paramètres sont conservés jusqu’à ce qu’ils soient explicitement modifiés. Les lignes d’application sont supprimées lorsque la session est fermée.
[in] dwType
Ce paramètre peut avoir l’une des valeurs suivantes.
[in] dwOperation
Ce paramètre peut avoir l’une des valeurs suivantes.
[out] lpszDestination
Multi-chaîne qui retourne les noms des ordinateurs vers lesquels l’interface utilisateur est redirigée. Ce paramètre ne peut pas avoir la valeur NULL.
Valeur retournée
Cette fonction retourne l’une des valeurs suivantes.
Valeur | Signification |
---|---|
|
L’accès à un ou plusieurs objets RSM est refusé. |
|
La destination donnée existe déjà dans la liste. |
|
Le handle de session est manquant ou n’est pas valide. |
|
le pointeur lpdwSize ou lpszDestination a la valeur NULL, ou lpObjectId n’est pas un conteneur valide, ou dwType ou dwOperation n’est pas l’une des trois valeurs valides. |
|
Un échec d’allocation s’est produit pendant le traitement. |
|
Le GUID spécifié par lpObjectId n’est pas le GUID d’un ordinateur ou d’un objet de bibliothèque dans la base de données. |
|
La fonction a réussi. |
Remarques
Un appel à SetNtmsUIOptions ajoute ou supprime une destination pour un instance particulier déterminé par les paramètres lpObjectId et dwType.
NTMS_UITYPE_INFO | NTMS_UITYPE_REQ | NTMS_UITYPE_ERR | |
---|---|---|---|
Application | Affichez l’interface utilisateur de progression des éléments de travail pour les éléments de travail générés par cette application. | Afficher l’interface utilisateur des demandes d’opérateur pour les demandes d’opérateur générées par les actions effectuées par cette application. | Non défini. Les applications ne peuvent pas provoquer ce type d’événement d’erreur. |
Bibliothèque | Afficher l’interface utilisateur de progression des éléments de travail pour les éléments de travail associés à cette bibliothèque. | Affichez l’interface utilisateur pour les requêtes associées à cette bibliothèque. | Affichez l’interface utilisateur pour les erreurs associées à cette bibliothèque. |
Computer | Affichez l’interface utilisateur d’informations dans cette instance de RSM en cours d’exécution sur cet ordinateur. | Affichez une interface utilisateur de type requête dans cette instance de RSM. | Affichez l’interface utilisateur de type d’erreur dans cette instance de RSM. |
Notez que des vérifications de sécurité sont effectuées lors de l’appel de SetNtmsUIOptions. Lorsque l’objet ordinateur est spécifié, vous devez disposer d’un accès avec l’autorisation nécessaire pour modifier l’ordinateur. Lorsque vous modifiez l’élément d’interface utilisateur d’une bibliothèque, vous devez disposer d’un accès avec l’autorisation nécessaire pour modifier l’objet de bibliothèque.
Notez qu’il n’existe aucune vérification des chaînes de destination. Un appel à avec un nom de destination qui n’est pas un ordinateur accessible à partir de l’ordinateur sur lequel SetNtmsUIOptions a appelé retourne la réussite. Un pointeur vers une chaîne vide signifie l’ordinateur local.
Notes
L’en-tête ntmsapi.h définit SetNtmsUIOptions comme un 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.
Configuration requise
Condition requise | Valeur |
---|---|
Client minimal pris en charge | Windows XP [applications de bureau uniquement] |
Serveur minimal pris en charge | Windows Server 2003 [applications de bureau uniquement] |
Plateforme cible | Windows |
En-tête | ntmsapi.h |
Bibliothèque | Ntmsapi.lib |
DLL | Ntmsapi.dll |