Función SHValidateUNC (shlobj_core.h)

  • Artículo

[SHValidateUNC está disponible para su uso en los sistemas operativos especificados en la sección Requisitos. Puede modificarse o no estar disponible en versiones posteriores.

Valida una ruta de acceso de convención de nomenclatura universal (UNC) mediante una llamada a WNetAddConnection3. La función permite al usuario escribir un nombre de documento o aplicación UNC de acceso a la red remota (ARN) desde el cuadro de diálogo Ejecutar del menú Inicio .

Sintaxis

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

Parámetros

[in, optional] hwndOwner

Tipo: HWND

Identificador de la ventana primaria, que se usa para mostrar la interfaz de usuario. Si no es necesario, este valor se puede establecer en NULL.

[in, out] pszFile

Tipo: PWSTR

Puntero a una cadena Unicode terminada en null que especifica la ruta de acceso UNC que se va a validar. Nota: Esta cadena no debe ser una cadena constante.

fConnect

Tipo: UINT

Uno o varios de los valores siguientes.

VALIDATEUNC_CONNECT (0x0001)

Conecte una letra de unidad. Cuando se establece esta marca, el valor de pszFile se cambia a la unidad local a la que se asigna el UNC en el equipo local.

VALIDATEUNC_NOUI (0x0002)

En caso de error o correcto, no se muestra ninguna interfaz de usuario.

VALIDATEUNC_PRINT (0x0004)

Valide como un recurso compartido de impresión en lugar de como recurso compartido de disco.

VALIDATEUNC_PERSIST (0x0008)

Windows Vista y versiones posteriores. La conexión debe ser persistente.

VALIDATEUNC_VALID

Valor de máscara usado para comprobar que las marcas que se pasan a SHValidateUNC son válidas.

Valor devuelto

Tipo: BOOL

Devuelve TRUE si existe la ruta de acceso UNC; FALSE si la ruta de acceso UNC no existe o si se produjo algún otro error.

Requisitos

Requisito Value
Cliente mínimo compatible Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado shlobj_core.h (incluya Shlobj.h)
Library Shell32.lib
Archivo DLL Shell32.dll (versión 5.00 o posterior)