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

Comparte la carpeta Usuarios o Público . Si la carpeta ya está compartida, este método actualiza su estado de uso compartido.

Sintaxis

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

Parámetros

[in] dsid

Tipo: DEF_SHARE_ID

Uno de los valores de DEF_SHARE_ID que indica la carpeta que se va a compartir o actualizar.

[in] role

Tipo: SHARE_ROLE

Uno de los siguientes valores SHARE_ROLE que establece los permisos de acceso del recurso compartido para la ACE Todos . CreateShare solo acepta estos valores.

SHARE_ROLE_READER (0)

Solo lectura. El contenido de la carpeta se puede leer, pero no modificar ni agregar a .

SHARE_ROLE_CO_OWNER (2)

Lectura y escritura. El contenido de la carpeta se puede leer, cambiar o agregar.

Valor devuelto

Tipo: HRESULT

Devuelve S_OK si se ejecuta correctamente o un valor de error de lo contrario, incluido lo siguiente:

Código devuelto	Descripción
E_INVALIDARG	El parámetro role especifica un valor distinto de SHARE_ROLE_READER o SHARE_ROLE_CO_OWNER.

Comentarios

La ejecución de este método requiere un nivel de privilegios de administrador.

Si la carpeta denominada en dsid no se comparte, este método comparte la carpeta mediante el nivel de permiso proporcionado en el parámetro role .

Si la carpeta denominada en dsid ya está compartida, este método actualiza los permisos en el recurso compartido con el valor proporcionado en el parámetro role .

Dado que a partir de Windows 7, la carpeta Pública se comparte a través de usuarios en lugar de directamente, la creación de un recurso compartido en Público hace que se cree un recurso compartido de bloque de mensajes del servidor (SMB) en usuarios.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	shobjidl_core.h (include Shobjidl.h)