Méthode ISharingConfigurationManager ::CreateShare (shobjidl_core.h)

  • Article

Partage le dossier Utilisateurs ou Public . Si le dossier est déjà partagé, cette méthode met à jour son status de partage.

Syntaxe

HRESULT CreateShare(
  [in] DEF_SHARE_ID dsid,
  [in] SHARE_ROLE   role
);

Paramètres

[in] dsid

Type : DEF_SHARE_ID

L’une des valeurs DEF_SHARE_ID qui indique le dossier à partager ou à mettre à jour.

[in] role

Type : SHARE_ROLE

L’une des valeurs de SHARE_ROLE suivantes qui définit les autorisations d’accès du partage pour l’ACE Tout le monde . CreateShare accepte uniquement ces valeurs.

SHARE_ROLE_READER (0)

Lecture seule. Le contenu du dossier peut être lu, mais pas modifié ou ajouté.

SHARE_ROLE_CO_OWNER (2)

Lecture/écriture. Le contenu du dossier peut être lu, modifié ou ajouté.

Valeur retournée

Type : HRESULT

Retourne S_OK en cas de réussite, ou une valeur d’erreur dans le cas contraire, y compris les éléments suivants :

Code de retour Description
E_INVALIDARG
 Le paramètre de rôle spécifie une valeur autre que SHARE_ROLE_READER ou SHARE_ROLE_CO_OWNER.

Remarques

L’exécution de cette méthode nécessite un niveau de privilège Administrateur.

Si le dossier nommé dans dsid n’est pas partagé, cette méthode partage le dossier à l’aide du niveau d’autorisation fourni dans le paramètre de rôle .

Si le dossier nommé dans dsid est déjà partagé, cette méthode met à jour les autorisations sur le partage avec la valeur fournie dans le paramètre de rôle .

Étant donné que, à partir de Windows 7, le dossier Public est partagé via Utilisateurs plutôt que directement, la création d’un partage sur Public entraîne la création d’un partage SMB (Server Message Block) sur Les utilisateurs.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2008 [applications de bureau uniquement]
Plateforme cible Windows
En-tête shobjidl_core.h (incluez Shobjidl.h)