Funzione NPGetPropertyText (npapi.h)

Recupera i nomi dei pulsanti da aggiungere a una finestra di dialogo delle proprietà per una risorsa di rete.

Sintassi

DWORD NPGetPropertyText(
  [in]      DWORD  iButton,
  [in]      DWORD  nPropSel,
  [in]      LPWSTR lpName,
  [out]     LPWSTR lpButtonName,
  [in, out] DWORD  nButtonNameLen,
  [in]      DWORD  nType
);

Parametri

[in] iButton

Indica l'indice del pulsante. Gestione file supporta un massimo di sei pulsanti. Questo parametro è numerato da 1 a 6 per ognuno dei pulsanti possibili se viene selezionato un solo file o 11-16 se sono selezionati più file.

[in] nPropSel

Specifica gli elementi a cui si concentra la finestra di dialogo proprietà. Questo può essere 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] lpName

Puntatore a una stringa con terminazione null contenente i nomi dell'elemento o degli elementi da visualizzare o modificare tramite la finestra di dialogo. Gli unici elementi supportati sono file e directory, quindi i nomi degli elementi sono nomi di file. Questi elementi devono essere non ambigui, non contengono caratteri jolly e devono essere completi (ad esempio, C:\LOCAL\EXAMPLE.DOC). È necessario separare più nomi di file con spazi. Un nome di file che contiene spazi può essere circondato da virgolette ,ad esempio "C:\My File"). In questo caso. viene considerato come un singolo nome. Il carattere di caret '^' può essere usato anche come meccanismo di virgolette per i singoli caratteri (ad esempio C:\My^"File, "C:\My^"File" fa riferimento al file C:\My"File).

[out] lpButtonName

Puntatore a un buffer in cui il provider di rete deve copiare il nome del pulsante della proprietà. In caso di esito positivo, il buffer a cui punta lpButtonName contiene il nome del pulsante della proprietà. Se questo buffer, all'uscita, contiene la stringa vuota, il pulsante corrispondente a tale nome e tutti i pulsanti riusciti verranno rimossi dalla finestra di dialogo. Il provider di rete non può "ignorare" un pulsante.

[in, out] nButtonNameLen

Specifica le dimensioni del buffer lpButtonName in caratteri, incluso il carattere null terminante.

[in] nType

Specifica il tipo di elemento, che deve essere WNTYPE_FILE.

Valore restituito

Se la funzione ha esito positivo, deve restituire WN_SUCCESS e lpButtonName può essere usata. Se punta alla stringa vuota, nessun pulsante corrisponde a un indice pari a iButton. Se il valore restituito è diverso da WN_SUCCESS, il provider deve chiamare anche SetLastError per impostare informazioni di errore estese. I codici di errore estesi includono quanto segue.

Codice restituito Descrizione
WN_OUT_OF_MEMORY
Impossibile caricare la stringa dalle risorse.
WN_MORE_DATA
Il buffer specificato è troppo piccolo per adattare il testo del pulsante.
WN_BAD_VALUE
Il parametro lpName è un modulo imprevisto.
WN_NOT_SUPPORTED
Le finestre di dialogo delle proprietà non sono supportate per il tipo di oggetto specificato, nType.

Commenti

Gestione file chiama questa funzione ogni volta che viene visualizzata la finestra di dialogo della proprietà e questa operazione viene eseguita prima di visualizzare la finestra di dialogo. Se l'utente fa clic su un pulsante aggiunto tramite questa funzione dal provider di rete, la funzione NPPropertyDialog viene chiamata con i parametri appropriati.

Solo Gestione file chiama NPGetPropertyText e usa questa funzione per file e directory.

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