NPPropertyDialog-Funktion (npapi.h)

Artikel
02/29/2024

Wird aufgerufen, wenn der Benutzer auf eine Schaltfläche klickt, die mithilfe der NPPropertyDialog-Funktion hinzugefügt wurde. Die NPPropertyDialog-Funktion wird nur für Datei- und Verzeichnisnetzwerkeigenschaften aufgerufen.

Syntax

DWORD NPPropertyDialog(
  [in] HWND   hwndParent,
  [in] DWORD  iButtonDlg,
  [in] DWORD  nPropSel,
  [in] LPWSTR lpFileName,
  [in] DWORD  nType
);

Parameter

[in] hwndParent

Ein Handle für das übergeordnete Fenster, das das Dateieigenschaftsdialogfeld besitzen soll.

[in] iButtonDlg

Der Index der Schaltfläche, die gedrückt wurde.

Dieser Index gibt an, welches Eigenschaftendialogfeld angefordert wurde, beginnend mit einem für die erste Schaltfläche, die von der NPGetPropertyText-Funktion zurückgegeben wurde. Wenn mehrere Dateinamen ausgewählt sind, wird dieser Zahl 10 hinzugefügt. Anders ausgedrückt: Wenn mehr als eine Datei ausgewählt ist und der Benutzer die erste vom Anbieter definierte Eigenschaftenschaltfläche drückt, ist iButtonDlg 11. Wenn nur eine Datei ausgewählt ist und der Benutzer die zweite Netzwerkeigenschaftenschaltfläche drückt, ist iButtonDlg zwei.

[in] nPropSel

Gibt an, auf welche Elemente das Eigenschaftendialogfeld reagieren soll. Dieser Parameter kann einen der folgenden Werte annehmen.

Wert	Bedeutung
WNPS_FILE	Eine einzelne Datei.
WNPS_DIR	Ein einzelnes Verzeichnis.
WNPS_MULT	Eine Auswahl mehrerer Dateien, Verzeichnisse oder beides.

[in] lpFileName

Ein Zeiger auf die Namen der Elemente, auf die das Eigenschaftendialogfeld reagieren soll. Die einzigen unterstützten Elemente sind Dateien und Verzeichnisse, sodass die Elementnamen Dateinamen sind. Diese sollten eindeutig sein, keine Wildcardzeichen enthalten und voll qualifiziert sein, z. B. C:\Local\Example.doc. Mehrere Dateinamen sollten durch Leerzeichen getrennt werden. Ein Dateiname, der Leerzeichen enthält, kann in Anführungszeichen eingeschlossen werden, z. B. "C:\Meine Datei". In diesem Fall wird er als einzelner Name behandelt. Ein Caret (^) kann auch als Anführungsmechanismus für einzelne Zeichen verwendet werden, z. B. beziehen sich C:\My^"File und "C:\My^"File" beide auf die Datei C:\My"File.

[in] nType

Gibt den Elementtyp an, der WNTYPE_FILE werden muss.

Rückgabewert

Wenn die Funktion erfolgreich ist, wird WN_SUCCESS zurückgegeben. Wenn die Ausführung der Funktion fehlschlägt, wird ein Fehlercode zurückgegeben. Rufen Sie SetLastError auf, um diesen erweiterten Fehlercode festzulegen, der die folgenden Rückgabecodes enthalten kann.

Rückgabecode	Beschreibung
WN_BAD_VALUE	Mindestens ein Parameter ist eine unerwartete Form oder ein unerwarteter Wert.
WN_OUT_OF_MEMORY	Es ist nicht genügend Arbeitsspeicher vorhanden, um das Dialogfeld anzuzeigen.
WN_NET_ERROR	Ein Netzwerkfehler ist aufgetreten.

Hinweise

Diese Funktion wird nur für Eigenschaftensätze aufgerufen, denen NPGetPropertyText einen Schaltflächennamen zugewiesen hat.

Diese Funktion wird im Datei-Manager verwendet, um die Netzwerkeigenschaften (z. B. Berechtigungen) für Dateien auf einem Netzwerkgerät anzuzeigen und zu ändern. Wenn diese Funktion nicht unterstützt wird, stellt der Datei-Manager kein Standardverhalten bereit.

In dieser Version der Netzwerkanbieterschnittstelle kann lpFileName nur auf Dateinamen verweisen. Der Netzwerkanbieter sollte WN_BAD_VALUE zurückgeben, wenn ein unangemessenes Gerät angezeigt wird.

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

Weitere Informationen

NPGetPropertyText

SetLastError

Freigeben über