Compartilhar via


Método IDiskQuotaControl::Initialize (dskquota.h)

Inicializa um novo objeto DiskQuotaControl abrindo o volume do sistema de arquivos NTFS com os direitos de acesso solicitados. O valor retornado indica se o volume dá suporte a cotas de disco do sistema de arquivos NTFS e se o chamador tem direitos de acesso suficientes.

Sintaxe

HRESULT Initialize(
  [in] LPCWSTR pszPath,
  [in] BOOL    bReadWrite
);

Parâmetros

[in] pszPath

O caminho para a raiz do volume, como C:\ ou \\yourcomputer.

[in] bReadWrite

Se esse valor for TRUE, o volume será aberto no modo de leitura/gravação. Se esse valor for FALSE, o volume será aberto no modo somente leitura. Para gravar dados no arquivo de cota, você deve especificar TRUE e a chamada para esse método deve retornar com êxito.

Valor retornado

Esse método retorna um dos valores a seguir.

Código de retorno Descrição
S_OK
Êxito.
ERROR_ACCESS_DENIED
O chamador não tem direitos de acesso suficientes.
ERROR_BAD_PATHNAME
O nome do caminho solicitado é inválido.
ERROR_FILE_NOT_FOUND
O arquivo ou objeto solicitado não foi encontrado.
ERROR_INITIALIZED
O objeto do controlador já foi inicializado. A inicialização múltipla não é permitida.
ERROR_INVALID_NAME
O caminho do arquivo solicitado é inválido.
ERROR_NOT_SUPPORTED
O sistema de arquivos não dá suporte a cotas.
ERROR_PATH_NOT_FOUND
O caminho do arquivo solicitado não foi encontrado.

Requisitos

   
Cliente mínimo com suporte Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho dskquota.h
DLL Dskquota.dll

Confira também

Interfaces do gerenciamento de disco

Cotas de disco

GetVolumePathName

IDiskQuotaControl