Função PathIsNetworkPathW (shlwapi.h)

Determina se uma cadeia de caracteres de caminho representa um recurso de rede.

Sintaxe

BOOL PathIsNetworkPathW(
  [in] LPCWSTR pszPath
);

Parâmetros

[in] pszPath

Tipo: LPCTSTR

Um ponteiro para uma cadeia de caracteres terminada em nulo de comprimento máximo MAX_PATH que contém o caminho.

Retornar valor

Tipo: BOOL

Retornará TRUE se a cadeia de caracteres representar um recurso de rede ou FALSE caso contrário.

Comentários

PathIsNetworkPath interpreta os dois tipos de caminhos a seguir como caminhos de rede.

• Os caminhos que começam com dois caracteres de barra invertida (\\) são interpretados como caminhos UNC (Convenção Universal de Nomenclatura).
• Caminhos que começam com uma letra seguida por dois-pontos (:) são interpretados como uma unidade de rede montada. No entanto, PathIsNetworkPath não pode reconhecer uma unidade de rede mapeada para uma letra da unidade por meio do comando SUBST do Microsoft MS-DOS ou da função DefineDosDevice .

Nota A função não verifica se o recurso de rede especificado existe, está acessível no momento ou se o usuário tem permissões suficientes para acessá-lo.

 

Observação

O cabeçalho shlwapi.h define PathIsNetworkPath como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 2000 Professional, Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	shlwapi.h
Biblioteca	Shlwapi.lib
DLL	Shlwapi.dll (versão 5.0 ou posterior)