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

Compartilha a pasta Usuários ou Pública . Se a pasta já estiver compartilhada, esse método atualizará sua status de compartilhamento.

Sintaxe

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

Parâmetros

[in] dsid

Tipo: DEF_SHARE_ID

Um dos valores de DEF_SHARE_ID que indica a pasta a ser compartilhada ou atualizada.

[in] role

Tipo: SHARE_ROLE

Um dos seguintes valores de SHARE_ROLE que define as permissões de acesso do compartilhamento para a ACE Todos . CreateShare aceita apenas esses valores.

SHARE_ROLE_READER (0)

Somente leitura. O conteúdo da pasta pode ser lido, mas não alterado ou adicionado.

SHARE_ROLE_CO_OWNER (2)

Leitura/gravação. O conteúdo da pasta pode ser lido, alterado ou adicionado a.

Retornar valor

Tipo: HRESULT

Retorna S_OK se tiver êxito ou um valor de erro, caso contrário, incluindo o seguinte:

Código de retorno	Descrição
E_INVALIDARG	O parâmetro role especifica um valor diferente de SHARE_ROLE_READER ou SHARE_ROLE_CO_OWNER.

Comentários

A execução desse método requer um nível de privilégio de Administrador.

Se a pasta nomeada em dsid não for compartilhada, esse método compartilhará a pasta usando o nível de permissão fornecido no parâmetro de função .

Se a pasta nomeada em dsid já estiver compartilhada, esse método atualizará as permissões no compartilhamento com o valor fornecido no parâmetro role .

Como a partir do Windows 7, a pasta Pública é compartilhada por meio de Usuários em vez de diretamente, a criação de um compartilhamento em Público faz com que um compartilhamento SMB (Server Message Block) seja criado em Usuários.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	shobjidl_core.h (inclua Shobjidl.h)