Export (0) Print
Expand All
Expand Minimize
This topic has not yet been rated - Rate this topic

SHValidateUNC function

[SHValidateUNC is available for use in the operating systems specified in the Requirements section. It may be altered or unavailable in subsequent versions.]

Validates a Universal Naming Convention (UNC) path by calling WNetAddConnection3. The function makes it possible for the user to type a remote network access (RNA) UNC application or document name from the Run dialog box on the Start menu.

Syntax


BOOL SHValidateUNC(
  _In_opt_  HWND hwndOwner,
  _Inout_   PWSTR pszFile,
  UINT fConnect
);

Parameters

hwndOwner [in, optional]

Type: HWND

Handle of the parent window, used to display UI. If this is not needed, this value can be set to NULL.

pszFile [in, out]

Type: PWSTR

A pointer to a null-terminated Unicode string that specifies the UNC path to validate. Note: This string must not be a constant string.

fConnect

Type: UINT

One or more of the following values.

VALIDATEUNC_CONNECT (0x0001)

Connect a drive letter. When this flag is set, the value in pszFile is changed to the local drive to which the UNC is mapped on the local machine.

VALIDATEUNC_NOUI (0x0002)

On either failure or success, display no UI.

VALIDATEUNC_PRINT (0x0004)

Validate as a print share rather than disk share.

VALIDATEUNC_PERSIST (0x0008)

Windows Vista and later. The connection should be made persistent.

VALIDATEUNC_VALID

Mask value used to verify that the flags passed to SHValidateUNC are valid.

Return value

Type: BOOL

Returns TRUE if the UNC path exists; FALSE if the UNC path does not exist or if some other failure occurred.

Requirements

Minimum supported client

Windows XP [desktop apps only]

Minimum supported server

Windows Server 2003 [desktop apps only]

End of client support

Windows Vista

End of server support

Windows Server 2003

Header

Shlobj.h

Library

Shell32.lib

DLL

Shell32.dll (version 5.00 or later)

 

 

Did you find this helpful?
(1500 characters remaining)
Thank you for your feedback

Community Additions

ADD
Show:
© 2014 Microsoft. All rights reserved.