NPGetDirectoryType-Funktion (npapi.h)

  • Artikel

Bestimmt den Typ eines Netzwerkverzeichnisses. Die NPGetDirectoryType-Funktion wird vom Datei-Manager verwendet.

Syntax

DWORD NPGetDirectoryType(
  [in] LPWSTR lpName,
  [in] LPINT  lpType,
  [in] BOOL   bFlushCache
);

Parameter

[in] lpName

Zeiger auf den vollqualifizierten Namen des Verzeichnisses. Der Netzwerkanbieter gibt den Typ an die Adresse zurück, auf die von lpType verwiesen wird. Wenn der in lpType zurückgegebene Wert null ist oder der Netzwerkanbieter einen Fehler zurückgibt, zeigt der Datei-Manager das Verzeichnis als "normales" Verzeichnis an.

[in] lpType

Zeiger auf einen vom Netzwerkanbieter definierten Wert. Dieser Wert wird verwendet, um die Anzeige der Laufwerkstruktur im Datei-Manager zu ändern. Auf diese Weise kann der Netzwerkanbieter dem Benutzer spezielle Verzeichnisse anzeigen.

[in] bFlushCache

Legen Sie auf TRUE fest, wenn der Datei-Manager MPR aufruft, um den Verzeichnistyp zum ersten Mal abzurufen, während ein Fenster bei Der Aktualisierung neu gestrichen wird. Anschließend ist es FALSE. Dies gibt einem Anbieter die Möglichkeit, die Leistung zu optimieren, wenn er die Daten für ein Laufwerk nur einmal lesen und dann bis zur nächsten Aktualisierung zwischenspeichern möchte.

Rückgabewert

Diese Funktion sollte bei erfolgreicher Ausführung WN_SUCCESS zurückgeben. Andernfalls sollte ein Fehlercode zurückgegeben werden, der folgendes enthalten kann.

Rückgabecode Beschreibung
WN_NOT_SUPPORTED

NPGetDirectoryType wird nicht unterstützt.

Hinweise

Der Datei-Manager stellt ein eigenes Symbol für alle speziellen Netzwerkverzeichnisse bereit. Das heißt, wenn lpType auf einen nichtzero-Wert festgelegt ist, zeigt der Datei-Manager ein spezielles Ordnersymbol an.

Die Implementierung dieser Funktion sollte mit hoher Leistung oder schnell erfolgen, da der Aufruf erfolgt, während der Datei-Manager die Verzeichnisstruktur zeichnet.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile npapi.h