dsmSetAccess

Editer en ligne

L'appel de fonction dsmSetAccess accorde aux autres utilisateurs et postes l'accès aux versions de sauvegarde ou aux copies d'archivage de vos objets, l'accès à tous vos objets et à un jeu sélectif. Lorsque vous accordez l'accès à un autre utilisateur, celui-ci peut interroger, restaurer ou récupérer vos fichiers. Cette commande accepte les caractères génériques pour les zones suivantes : fs, hl, ll, node, owner.

Remarque: Vous ne pouvez pas autoriser l'accès aux versions de sauvegarde et aux copies d'archivage à l'aide d'une seule commande. Vous devez indiquer s'il s'agit de la sauvegarde ou de l'archivage.

Syntaxe

dsInt16_t DSMLINKAGE dsmSetAccess
        (dsUint32_t          dsmHandle,
         dsmSetAccessType    accessType,
         dsmObjName          *objNameP,
         char                *node,
         char                *owner);

Paramètres

dsUint32_t dsmHandle (I)

Descripteur qui associe cet appel à un appel dsmInitEx précédent.

dsmAccessType accessType (I)

Ce paramètre spécifie le type d'objet pour lequel vous souhaitez accorder l'accès. Les valeurs possibles incluent :

	Nom	Description
	atBackup	Indique que l'accès est défini pour les objets de sauvegarde.
	atArchive	Indique que l'accès est défini pour les objets archivés.

dsmObjName *objNameP (I)

Ce paramètre est un pointeur vers la structure qui contient le nom d'espace fichier, le nom d'objet de haut niveau et le nom d'objet de bas niveau.

Remarque: Pour spécifier tous les espaces fichier, utilisez un astérisque (*) comme nom d'espace fichier.

char *node (I)

Ce paramètre est un pointeur vers le nom de poste pour lequel l'accès est accordé. Pour spécifier tous les postes, indiquez un astérisque (*).

char *owner (I)

Ce paramètre est un pointeur vers le nom d'utilisateur sur le poste auquel vous avez accordé l'accès. Pour spécifier tous les utilisateurs, indiquez un astérisque (*).

Codes retour

Les numéros de code retour sont indiqués entre parenthèses ( ).

Tableau 1. Code retour pour dsmSetAccess
Code retour	Explication
DSM_RC_INVALID_ACCESS_TYPE (2110)	Type d'accès non valide spécifié.
DSM_RC_FILE_SPACE_NOT_FOUND (124)	L'espace fichier indiqué est introuvable sur le serveur.
DSM_RC_QUERY_COMM_FAILURE (2111)	Erreur de communication lors de la requête au serveur.
DSM_RC_NO_FILES_BACKUP (2112)	Aucun fichier n'a été sauvegardé pour cet espace fichier.
DSM_RC_NO_FILES_ARCHIVE (2113)	Aucun fichier n'a été archivé pour cet espace fichier.
DSM_RC_INVALID_SETACCESS (2114)	Formulation de définition d'accès non valide.