IDiskQuotaUser::GetName-Methode (dskquota.h)

  • Artikel

Ruft die Namenszeichenfolgen ab, die einem Datenträgerkontingentbenutzer zugeordnet sind.

Syntax

HRESULT GetName(
  [out] LPWSTR pszAccountContainer,
  [in]  DWORD  cchAccountContainer,
  [out] LPWSTR pszLogonName,
  [in]  DWORD  cchLogonName,
  [out] LPWSTR pszDisplayName,
  [in]  DWORD  cchDisplayName
);

Parameter

[out] pszAccountContainer

Der Name des Kontocontainers des Benutzers. Dieser Wert kann NULL sein. Bei Konten ohne Verzeichnisdienstinformationen ist diese Zeichenfolge einfach der Domänenname. Bei Konten mit verfügbaren Verzeichnisdienstinformationen handelt es sich bei dieser Zeichenfolge um einen kanonischen Namen, bei dem der Endobjektname entfernt wurde.

[in] cchAccountContainer

Die Größe des Kontocontainerpuffers in Zeichen. Wird ignoriert, wenn pszAccountContainerNULL ist.

[out] pszLogonName

Ein Zeiger auf den Puffer, um den Namen zu erhalten, den der Benutzer für die Anmeldung am Computer angegeben hat. Dieser Wert kann NULL sein. Das Format des zurückgegebenen Namens hängt davon ab, ob Verzeichnisdienstinformationen verfügbar sind.

[in] cchLogonName

Die Größe des Anmeldenamenpuffers in Zeichen. Wird ignoriert, wenn pszLogonNameNULL ist.

[out] pszDisplayName

Ein Zeiger auf den Puffer, um den Anzeigenamen für den Kontingentbenutzer zu erhalten. Dieser Wert kann NULL sein. Wenn die Informationen nicht verfügbar sind, hat die zurückgegebene Zeichenfolge die Länge null.

[in] cchDisplayName

Die Größe des Anzeigenamenpuffers in Zeichen. Wird ignoriert, wenn pszDisplayNameNULL ist.

Rückgabewert

Diese Methode gibt einen der folgenden Werte zurück.

Rückgabecode BESCHREIBUNG
S_OK
 Erfolg.
ERROR_LOCK_FAILED
 Fehler beim Abrufen einer exklusiven Sperre.

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

IDiskQuotaUser