Funzione NPGetUniversalName (npapi.h)

  • Articolo

Recupera il nome universale di una risorsa di rete. La funzione NPGetUniversalName può recuperare questo nome universale in formato UNC o nel formato di nome remoto precedente.

Sintassi

DWORD NPGetUniversalName(
  [in]      LPCWSTR lpLocalPath,
  [in]      DWORD   dwInfoLevel,
  [out]     LPVOID  lpBuffer,
  [in, out] LPDWORD lpBufferSize
);

Parametri

[in] lpLocalPath

Puntatore al percorso locale di un oggetto in una risorsa di rete. Si tratta di un percorso basato su unità.

[in] dwInfoLevel

Il livello di dettaglio delle informazioni da parte del chiamante è interessato. Questo può essere uno dei valori seguenti.

Valore Significato
UNIVERSAL_NAME_INFO_LEVEL
 Recupera il formato UNC del nome, ad esempio "file:\\server\share"

Se questo valore è impostato, i dati restituiti in lpBuffer vengono archiviati come struttura UNIVERSAL_NAME_INFO .
REMOTE_NAME_INFO_LEVEL
 Recupera la forma remota del nome, ad esempio "\\server\share"

Se questo valore è impostato, i dati restituiti in lpBuffer vengono archiviati come struttura REMOTE_NAME_INFO .

[out] lpBuffer

Puntatore a un buffer per ricevere le informazioni richieste dall'utente. La struttura specifica restituita dipende dal livello di informazioni specificato in dwInfoLevel.

[in, out] lpBufferSize

Puntatore alle dimensioni, in byte, del buffer lpBuffer . Se la chiamata ha esito negativo perché il buffer non è abbastanza grande, questa posizione verrà usata per restituire le dimensioni del buffer necessarie.

Valore restituito

Se la funzione ha esito positivo, deve restituire WN_SUCCESS. In caso contrario, deve restituire un codice di errore, che può essere uno dei seguenti.

Codice restituito Descrizione
WN_BAD_LOCALNAME
 Il valore passato in lpLocalPath non è valido.
WN_NOT_CONNECTED
 Il valore passato in lpLocalPath non è un dispositivo reindirizzato.
WN_MORE_DATA
 Il buffer è troppo piccolo.
WN_NO_NETWORK
 La rete non è presente.

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