ISharingConfigurationManager::CreateShare-Methode (shobjidl_core.h)

  • Artikel

Gibt den Ordner "Benutzer" oder " Öffentlich" auf . Wenn der Ordner bereits freigegeben ist, aktualisiert diese Methode die Freigabe status.

Syntax

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

Parameter

[in] dsid

Typ: DEF_SHARE_ID

Einer der DEF_SHARE_ID Werte, der den Ordner angibt, der freigegeben oder aktualisiert werden soll.

[in] role

Typ: SHARE_ROLE

Einer der folgenden SHARE_ROLE Werte, der die Zugriffsberechtigungen der Freigabe für den Ace "Jeder " festlegt. CreateShare akzeptiert nur diese Werte.

SHARE_ROLE_READER (0)

Schreibgeschützt. Der Inhalt des Ordners kann gelesen, aber nicht geändert oder hinzugefügt werden.

SHARE_ROLE_CO_OWNER (2)

Lesen/Schreiben Der Inhalt des Ordners kann gelesen, geändert oder hinzugefügt werden.

Rückgabewert

Typ: HRESULT

Gibt bei erfolgreicher Ausführung S_OK oder andernfalls einen Fehlerwert zurück, einschließlich der folgenden:

Rückgabecode Beschreibung
E_INVALIDARG
 Der Role-Parameter gibt einen anderen Wert als SHARE_ROLE_READER oder SHARE_ROLE_CO_OWNER an.

Hinweise

Für die Ausführung dieser Methode ist eine Administratorberechtigungsstufe erforderlich.

Wenn der Ordner mit dem Namen in dsid nicht freigegeben ist, gibt diese Methode den Ordner mit der im Rollenparameter angegebenen Berechtigungsstufe frei.

Wenn der Ordner mit dem Namen in dsid bereits freigegeben ist, aktualisiert diese Methode die Berechtigungen für die Freigabe mit dem im role-Parameter angegebenen Wert.

Da ab Windows 7 der Öffentliche Ordner über Benutzer und nicht direkt freigegeben wird, bewirkt das Erstellen einer Freigabe für Öffentlich , dass eine SMB-Freigabe (Server Message Block) für Benutzer erstellt wird.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile shobjidl_core.h (shobjidl.h einschließen)