Função SHValidateUNC (shlobj_core.h)

  • Artigo

[SHValidateUNC está disponível para uso nos sistemas operacionais especificados na seção Requisitos. Ele pode estar alterado ou indisponível em versões subsequentes.]

Valida um caminho UNC (Convenção Universal de Nomenclatura) chamando WNetAddConnection3. A função possibilita que o usuário digite um aplicativo UNC de acesso remoto à rede (RNA) ou um nome de documento na caixa de diálogo Executar no menu Iniciar .

Sintaxe

BOOL SHValidateUNC(
  [in, optional] HWND  hwndOwner,
  [in, out]      PWSTR pszFile,
                 UINT  fConnect
);

Parâmetros

[in, optional] hwndOwner

Digite: HWND

Identificador da janela pai, usada para exibir a interface do usuário. Se isso não for necessário, esse valor poderá ser definido como NULL.

[in, out] pszFile

Tipo: PWSTR

Um ponteiro para uma cadeia de caracteres Unicode terminada em nulo que especifica o caminho UNC a ser validado. Observação: essa cadeia de caracteres não deve ser uma cadeia de caracteres constante.

fConnect

Tipo: UINT

Um ou mais dos valores a seguir.

VALIDATEUNC_CONNECT (0x0001)

Conecte uma letra da unidade. Quando esse sinalizador é definido, o valor em pszFile é alterado para a unidade local para a qual o UNC é mapeado no computador local.

VALIDATEUNC_NOUI (0x0002)

Em caso de falha ou êxito, não exiba nenhuma interface do usuário.

VALIDATEUNC_PRINT (0x0004)

Valide como um compartilhamento de impressão em vez de compartilhamento de disco.

VALIDATEUNC_PERSIST (0x0008)

Windows Vista e posteriores. A conexão deve ser persistente.

VALIDATEUNC_VALID

Valor de máscara usado para verificar se os sinalizadores passados para SHValidateUNC são válidos.

Retornar valor

Tipo: BOOL

Retornará TRUE se o caminho UNC existir; FALSE se o caminho UNC não existir ou se alguma outra falha tiver ocorrido.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho shlobj_core.h (inclua Shlobj.h)
Biblioteca Shell32.lib
DLL Shell32.dll (versão 5.00 ou posterior)