Metodo ISharingConfigurationManager::CreateShare (shobjidl_core.h)

Condivide la cartella Users o Public . Se la cartella è già condivisa, questo metodo ne aggiorna lo stato di condivisione.

Sintassi

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

Parametri

[in] dsid

Tipo: DEF_SHARE_ID

Uno dei valori DEF_SHARE_ID che indica la cartella da condividere o aggiornare.

[in] role

Tipo: SHARE_ROLE

Uno dei valori di SHARE_ROLE seguenti che imposta le autorizzazioni di accesso della condivisione per everyone ACE. CreateShare accetta solo questi valori.

SHARE_ROLE_READER (0)

Di sola lettura. Il contenuto della cartella può essere letto, ma non modificato o aggiunto a .

SHARE_ROLE_CO_OWNER (2)

Lettura/Scrittura. Il contenuto della cartella può essere letto, modificato o aggiunto a .

Valore restituito

Tipo: HRESULT

Restituisce S_OK in caso di esito positivo o un valore di errore, incluso quanto segue:

Commenti

L'esecuzione di questo metodo richiede un livello di privilegi di amministratore.

Se la cartella denominata in dsid non è condivisa, questo metodo condivide la cartella usando il livello di autorizzazione fornito nel parametro role .

Se la cartella denominata in dsid è già condivisa, questo metodo aggiorna le autorizzazioni per la condivisione con il valore specificato nel parametro role .

Poiché a partire da Windows 7 la cartella Pubblica viene condivisa tramite Utenti anziché direttamente, la creazione di una condivisione in pubblico determina la creazione di una condivisione SMB (Server Message Block) negli utenti.

Requisiti