Método SetShareInfo da classe Win32_Share
O método de classe WMISetShareInfo define os parâmetros de um recurso compartilhado.
Este tópico usa a sintaxe MOF (Managed Object Format). Para obter mais informações sobre como usar esse método, consulte Chamando um método.
Sintaxe
uint32 SetShareInfo(
[in, optional] uint32 MaximumAllowed,
[in, optional] string Description,
[in, optional] Win32_SecurityDescriptor Access
);
Parâmetros
-
MaximumAllowed [in, opcional]
-
Limite o número máximo de usuários autorizados a usar esse recurso simultaneamente.
Exemplo: 10. Esse parâmetro é opcional.
-
Descrição [in, opcional]
-
Comentário opcional para descrever o recurso que está sendo compartilhado.
-
Acesso [in, opcional]
-
Descritor de segurança para permissões no nível do usuário. Um descritor de segurança contém informações sobre as funcionalidades de permissão, proprietário e acesso do recurso. Para obter mais informações, consulte Win32_SecurityDescriptor.
Valor retornado
Retorna um dos valores listados na lista a seguir ou qualquer outro valor para indicar um erro.
-
Sucesso (0)
-
Acesso negado (2)
-
Falha desconhecida (8)
-
Nome inválido (9)
-
Nível inválido (10)
-
Parâmetro inválido (21)
-
Compartilhamento duplicado (22)
-
Caminho redirecionado (23)
-
Dispositivo ou diretório desconhecido (24)
-
Nome líquido não encontrado (25)
-
Outro (26 4294967295)
Comentários
O método SetShareInfo é um método de objeto dinâmico e é usado em uma ocorrência dessa classe.
Somente os membros do grupo local Administradores ou Operadores de Conta ou aqueles com associação de grupo de operadores de Comunicação, Impressão ou Servidor podem executar SetShareInfo com êxito. O operador de impressão só pode definir filas de impressora. O operador comunicação só pode definir filas de dispositivos de comunicação.
Exemplos
O exemplo do PowerShell a seguir atualiza o nome do compartilhamento newShare .
$newShare = Get-WmiObject win32_share | Where-Object {$_.name -eq "newShare"}
[void]$newShare.SetShareInfo($null,"This is my new description",$null)
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte |
Windows Vista |
| Servidor mínimo com suporte |
Windows Server 2008 |
| Namespace |
Root\CIMV2 |
| MOF |
|
| DLL |
|