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

Article
03/02/2024

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)

Partager via