IDiskQuotaControl::Initialize-Methode (dskquota.h)

Artikel
08/23/2023

Initialisiert ein neues DiskQuotaControl-Objekt , indem das NTFS-Dateisystemvolume mit den angeforderten Zugriffsrechten geöffnet wird. Der Rückgabewert gibt an, ob das Volume NTFS-Dateisystem-Datenträgerkontingente unterstützt und ob der Aufrufer über ausreichende Zugriffsrechte verfügt.

Syntax

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

Parameter

[in] pszPath

Der Pfad zum Volumestamm, z. B. C:\ oder \\Ihr Computer.

[in] bReadWrite

Wenn dieser Wert TRUE ist, wird das Volume im Lese-/Schreibmodus geöffnet. Wenn dieser Wert FALSE ist, wird das Volume im schreibgeschützten Modus geöffnet. Um Daten in die Kontingentdatei zu schreiben, müssen Sie TRUE angeben, und der Aufruf dieser Methode muss erfolgreich zurückgegeben werden.

Rückgabewert

Diese Methode gibt einen der folgenden Werte zurück.

Rückgabecode	BESCHREIBUNG
S_OK	Erfolg.
ERROR_ACCESS_DENIED	Der Aufrufer verfügt über unzureichende Zugriffsrechte.
ERROR_BAD_PATHNAME	Der angeforderte Pfadname ist ungültig.
ERROR_FILE_NOT_FOUND	Die angeforderte Datei oder das angeforderte Objekt wurde nicht gefunden.
ERROR_INITIALIZED	Das Controllerobjekt wurde bereits initialisiert. Die mehrfache Initialisierung ist nicht zulässig.
ERROR_INVALID_NAME	Der angeforderte Dateipfad ist ungültig.
ERROR_NOT_SUPPORTED	Das Dateisystem unterstützt keine Kontingente.
ERROR_PATH_NOT_FOUND	Der angeforderte Dateipfad wurde nicht gefunden.

Anforderungen


Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	dskquota.h
DLL	Dskquota.dll

Weitere Informationen

Schnittstellen für die Datenträgerverwaltung

Datenträgerkontingente

GetVolumePathName

IDiskQuotaControl

Freigeben über