Compartilhar via


Método TakeOwnerShipEx da classe Win32_ShortcutFile

O método de classe WMITakeOwnerShipEx obtém a propriedade do arquivo de atalho lógico especificado no caminho do objeto. Esse método é uma versão estendida do método TakeOwnerShip . Se o arquivo lógico for, na verdade, um diretório, esse método atuará recursivamente, assumindo a propriedade de todos os arquivos e subdiretórios que o diretório contém.

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 TakeOwnerShipEx(
  [out]          string  StopFileName,
  [in, optional] string  StartFileName,
  [in, optional] boolean Recursive
);

Parâmetros

StopFileName [out]

Nome do arquivo ou diretório em que o método TakeOwnerShipEx falhou. Esse parâmetro será nulo se o método for bem-sucedido.

StartFileName [in, opcional]

Nomeia o arquivo ou diretório filho a ser usado como ponto de partida para TakeOwnerShipEx. O parâmetro StartFileName normalmente é o parâmetro StopFileName que especifica o arquivo ou diretório no qual ocorreu um erro da chamada de método anterior. Se esse parâmetro for NULL, a operação será executada no arquivo ou diretório especificado na chamada ExecMethod.

Recursivo [in, opcional]

Se for true, a alteração de propriedade será aplicada recursivamente a arquivos e diretórios dentro do diretório especificado pela instância de CIM_LogicalFile .

Observação

Para instâncias de arquivo, o parâmetro Recursive é ignorado.

Valor retornado

Retorna um valor de 0 (zero) em caso de êxito e qualquer outro número para indicar um erro.

0

A solicitação foi bem-sucedida.

2

O acesso foi negado.

8

Ocorreu uma falha não especificada.

9

O nome especificado não era válido.

10

O objeto especificado já existe.

11

O sistema de arquivos não é NTFS.

12

A plataforma não é o Windows.

13

A unidade não é a mesma.

14

O diretório não está vazio.

15

Houve uma violação de compartilhamento.

16

O arquivo inicial especificado não era válido.

17

Um privilégio necessário para a operação não é mantido.

21

Um parâmetro especificado não é válido.

Requisitos

Requisito Valor
Cliente mínimo com suporte
Windows Vista
Servidor mínimo com suporte
Windows Server 2008
Namespace
Root\CIMV2
MOF
CIMWin32.mof
DLL
CIMWin32.dll

Confira também

Classes do sistema operacional

Win32_ShortcutFile