Поделиться через

Метод CreateFileShare класса MSFT_FileServer

  • Статья

Создает общую папку на файловом сервере.

Синтаксис

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
);

Параметры

Имя [in]

Полууникальный (с областью действия на файловом сервере-владельце), удобочитаемая строка, используемая для идентификации общей папки.

Описание [в]

Настраиваемое пользователем описание общей папки. Это поле можно использовать для хранения дополнительных сведений в свободной форме, например примечаний или сведений о предполагаемом использовании.

SourceVolume [in]

Строка, содержащая внедренный объект MSFT_Volume , указывающий том, на котором будет создана общая папка.

VolumeRelativePath [in]

Относительный путь к тому существующего каталога для совместного использования. Если этот параметр не указан, будет создана пустая общая папка.

ContinuouslyAvailable [in]

Если задано значение TRUE, общая папка будет постоянно доступна.

EncryptData [in]

Если задано значение TRUE, данные общего ресурса будут зашифрованы во время транспортировки.

FileSharingProtocol [in]

Протокол общего доступа к файлам, используемый общей папкой, если сервер поддерживает несколько протоколов.

NFS (2)

CIFS(SMB) (3)

CreatedFileShare [out]

Этот параметр получает строку, содержащую внедренный объект MSFT_FileShare , представляющий новую общую папку.

CreatedStorageJob [out]

Возвращает ссылку на объект задания хранения, используемый для отслеживания длительной операции.

ExtendedStatus [out]

Строка, содержащая внедренный объект MSFT_StorageExtendedStatus .

Этот параметр позволяет поставщику хранилища возвращать расширенные (зависящие от реализации) сведения об ошибках.

Возвращаемое значение

Успешно (0)

Не поддерживается (1)

Неуказаная ошибка (2)

Время ожидания (3)

Сбой (4)

Недопустимый параметр (5)

Проверенные параметры метода — задание запущено (4096)

Размер не поддерживается (4097)

Доступ запрещен (40001)

Недостаточно ресурсов для завершения операции. (40002)

Запрошенный путь доступа уже используется. (42002)

Недопустимый путь доступа. (42007)

Необходимо указать имя для этой общей папки. (58000)

Необходимо указать протокол общего доступа для этой общей папки. (58001)

Необходимо указать том для этой общей папки. (58002)

Требования

Требование Значение
Минимальная версия клиента Windows 10 [только классические приложения]
Минимальная версия сервера Windows Server 2016 [только классические приложения]
Пространство имен Root\Microsoft\Windows\Storage
MOF Storagewmi.mof

См. также раздел

MSFT_FileServer