Funzione NPPropertyDialog (npapi.h)

  • Articolo

Chiamato quando l'utente fa clic su un pulsante aggiunto usando la funzione NPPropertyDialog . La funzione NPPropertyDialog viene chiamata solo per le proprietà di rete di file e directory.

Sintassi

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

Parametri

[in] hwndParent

Handle per la finestra padre che deve essere proprietaria della finestra di dialogo della proprietà del file.

[in] iButtonDlg

Indice del pulsante premuto.

Questo indice specifica la finestra di dialogo della proprietà richiesta, a partire da una per il primo pulsante restituito dalla funzione NPGetPropertyText . Se sono selezionati più nomi di file, 10 viene aggiunto a questo numero. In altre parole, se sono presenti più file selezionati e l'utente preme il primo pulsante di proprietà definito dal provider, iButtonDlg sarà 11. Se è selezionato un solo file e l'utente preme il secondo pulsante della proprietà di rete, iButtonDlg sarà due.

[in] nPropSel

Specifica gli elementi su cui deve agire la finestra di dialogo della proprietà. Questo parametro può avere uno dei valori seguenti.

Valore Significato
WNPS_FILE
 Un singolo file.
WNPS_DIR
 Una singola directory.
WNPS_MULT
 Selezione di più file, directory o entrambi.

[in] lpFileName

Puntatore ai nomi degli elementi su cui deve agire la finestra di dialogo della proprietà. Gli unici elementi supportati sono file e directory, quindi i nomi degli elementi sono nomi di file. Devono essere non ambigui, non contenere caratteri jolly e essere completi, ad esempio C:\Local\Example.doc. È necessario separare più nomi di file con spazi. Un nome file che contiene spazi può essere racchiuso tra virgolette, ad esempio "C:\My File". In questo caso, viene considerato come un singolo nome. Un cursore (^) può essere usato anche come meccanismo di virgolette per singoli caratteri, ad esempio C:\My^"File e "C:\My^"File" fanno entrambi riferimento al file C:\My"File.

[in] nType

Specifica il tipo di elemento, che deve essere WNTYPE_FILE.

Valore restituito

Se la funzione ha esito positivo, restituisce WN_SUCCESS. Se la funzione non viene completata, restituisce un codice di errore. Chiamare SetLastError per impostare questo codice di errore esteso, che può includere i codici restituiti seguenti.

Codice restituito Descrizione
WN_BAD_VALUE
 Uno o più parametri sono una maschera o un valore imprevisto.
WN_OUT_OF_MEMORY
 Memoria insufficiente per visualizzare la finestra di dialogo.
WN_NET_ERROR
 Si è verificato un errore di rete.

Commenti

Questa funzione viene chiamata solo su set di proprietà per cui NPGetPropertyText ha assegnato un nome di pulsante.

Questa funzione viene usata in Gestione file per visualizzare e modificare le proprietà di rete ,ad esempio le autorizzazioni, per i file in un dispositivo di rete. Se questa funzione non è supportata, Gestione file non fornisce alcun comportamento predefinito.

In questa versione dell'interfaccia del provider di rete lpFileName può puntare solo ai nomi di file. Il provider di rete deve restituire WN_BAD_VALUE se rileva un dispositivo inappropriato.

Requisiti

Requisito Valore
Client minimo supportato Windows XP [solo app desktop]
Server minimo supportato Windows Server 2003 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione npapi.h

Vedi anche

NPGetPropertyText

SetLastError