Condividi tramite

Funzione PathIsNetworkPathA (shlwapi.h)

  • Articolo

Determina se una stringa di percorso rappresenta una risorsa di rete.

Sintassi

BOOL PathIsNetworkPathA(
  [in] LPCSTR pszPath
);

Parametri

[in] pszPath

Tipo: LPCTSTR

Puntatore a una stringa con terminazione Null di lunghezza massima MAX_PATH che contiene il percorso.

Valore restituito

Tipo: bool

Restituisce TRUE se la stringa rappresenta una risorsa di rete o false in caso contrario.

Osservazioni

PathIsNetworkPath interpreta i due tipi di percorsi seguenti come percorsi di rete.

  • I percorsi che iniziano con due caratteri barra rovesciata (\\) vengono interpretati come percorsi UNC (Universal Naming Convention).
  • I percorsi che iniziano con una lettera seguita da due punti (:) vengono interpretati come un'unità di rete montata. Tuttavia, PathIsNetworkPath non è in grado di riconoscere un'unità di rete mappata a una lettera di unità tramite il comando SUBST di Microsoft MS-DOS o la funzione DefineDosDevice.
Nota La funzione non verifica che la risorsa di rete specificata esista, sia attualmente accessibile o che l'utente disponga di autorizzazioni sufficienti per accedervi.
 

Nota

L'intestazione shlwapi.h definisce PathIsNetworkPath come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

Requisito Valore
client minimo supportato Windows 2000 Professional, Windows XP [solo app desktop]
server minimo supportato Windows 2000 Server [solo app desktop]
piattaforma di destinazione Finestre
intestazione shlwapi.h
libreria Shlwapi.lib
dll Shlwapi.dll (versione 5.0 o successiva)