Compartilhar via


Método CreateFileShare da classe MSFT_FileServer

Cria um compartilhamento de arquivos no servidor de arquivos.

Sintaxe

UInt32 CreateFileShare(
  [in]  String              Name,
  [in]  String              Description,
  [in]  String              SourceVolume,
  [in]  String              VolumeRelativePath,
  [in]  Boolean             ContinuouslyAvailable,
  [in]  Boolean             EncryptData,
  [in]  UInt16              FileSharingProtocol,
  [out] String              CreatedFileShare,
  [out] MSFT_StorageJob REF CreatedStorageJob,
  [out] String              ExtendedStatus
);

Parâmetros

Nome [in]

Uma cadeia de caracteres semi-exclusiva (com escopo para o servidor de arquivos proprietário), legível por humanos, usada para identificar o compartilhamento de arquivos.

Descrição [in]

Uma descrição configurável pelo usuário do compartilhamento de arquivos. Esse campo pode ser usado para armazenar informações adicionais de forma livre, como anotações ou detalhes sobre o uso pretendido.

SourceVolume [in]

Uma cadeia de caracteres que contém um objeto MSFT_Volume inserido especificando o volume no qual o compartilhamento deve ser criado.

VolumeRelativePath [in]

O caminho relativo do volume de um diretório existente a ser compartilhado. Se esse parâmetro não for fornecido, um compartilhamento vazio será criado.

Continuamente Disponível [in]

Se TRUE, o compartilhamento estará continuamente disponível.

EncryptData [in]

Se TRUE, os dados de compartilhamento serão criptografados durante o transporte.

FileSharingProtocol [in]

O protocolo de compartilhamento de arquivos a ser usado pelo compartilhamento se o servidor der suporte a mais de um protocolo.

NFS (2)

CIFS(SMB) (3)

CreatedFileShare [out]

Esse parâmetro recebe uma cadeia de caracteres que contém um objeto MSFT_FileShare inserido que representa o novo compartilhamento de arquivos.

CreatedStorageJob [out]

Retorna uma referência ao objeto de trabalho de armazenamento usado para acompanhar a operação de execução longa.

ExtendedStatus [out]

Uma cadeia de caracteres que contém um objeto MSFT_StorageExtendedStatus inserido.

Esse parâmetro permite que o provedor de armazenamento retorne informações de erro estendidas (específicas da implementação).

Retornar valor

Êxito (0)

Sem suporte (1)

Erro não especificado (2)

Tempo limite (3)

Falha (4)

Parâmetro inválido (5)

Parâmetros de método verificados – Trabalho iniciado (4096)

Tamanho sem suporte (4097)

Acesso negado (40001)

Não há recursos suficientes para concluir a operação. (40002)

O caminho de acesso solicitado já está em uso. (42002)

O caminho de acesso não é válido. (42007)

Você deve especificar um nome para esse compartilhamento de arquivos. (58000)

Você deve especificar um protocolo de compartilhamento para esse compartilhamento de arquivos. (58001)

Você deve especificar um volume para esse compartilhamento de arquivos. (58002)

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 10 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2016 [somente aplicativos da área de trabalho]
Namespace Root\Microsoft\Windows\Storage
MOF Storagewmi.mof

Confira também

MSFT_FileServer