Skip to content

Latest commit

 

History

History
84 lines (64 loc) · 3.4 KB

nf-shobjidl_core-iitemnamelimits-getvalidcharacters.md

File metadata and controls

84 lines (64 loc) · 3.4 KB
UID title description helpviewer_keywords old-location tech.root ms.assetid ms.date ms.keywords req.header req.include-header req.target-type req.target-min-winverclnt req.target-min-winversvr req.kmdf-ver req.umdf-ver req.ddi-compliance req.unicode-ansi req.idl req.max-support req.namespace req.assembly req.type-library req.lib req.dll req.irql targetos req.typenames req.redist ms.custom f1_keywords dev_langs topic_type api_type api_location api_name
NF:shobjidl_core.IItemNameLimits.GetValidCharacters
IItemNameLimits::GetValidCharacters (shobjidl_core.h)
Loads a string that contains each of the characters that are valid or invalid in the namespace under which it is called.
GetValidCharacters
GetValidCharacters method [Windows Shell]
GetValidCharacters method [Windows Shell]
IItemNameLimits interface
IItemNameLimits interface [Windows Shell]
GetValidCharacters method
IItemNameLimits.GetValidCharacters
IItemNameLimits::GetValidCharacters
_shell_IItemNameLimits_GetValidCharacters
shell.IItemNameLimits_GetValidCharacters
shobjidl_core/IItemNameLimits::GetValidCharacters
shell\IItemNameLimits_GetValidCharacters.htm
shell
a6328be9-accd-4f11-82ee-49d3b18f9fd6
12/05/2018
GetValidCharacters, GetValidCharacters method [Windows Shell], GetValidCharacters method [Windows Shell],IItemNameLimits interface, IItemNameLimits interface [Windows Shell],GetValidCharacters method, IItemNameLimits.GetValidCharacters, IItemNameLimits::GetValidCharacters, _shell_IItemNameLimits_GetValidCharacters, shell.IItemNameLimits_GetValidCharacters, shobjidl_core/IItemNameLimits::GetValidCharacters
shobjidl_core.h
Shobjidl.h
Windows
Windows XP [desktop apps only]
Windows Server 2003 [desktop apps only]
Shobjidl.idl
Shell32.dll
Windows
19H1
IItemNameLimits::GetValidCharacters
shobjidl_core/IItemNameLimits::GetValidCharacters
c++
APIRef
kbSyntax
COM
Shell32.dll
IItemNameLimits.GetValidCharacters

IItemNameLimits::GetValidCharacters

-description

Loads a string that contains each of the characters that are valid or invalid in the namespace under which it is called.

-parameters

-param ppwszValidChars [out]

Type: LPWSTR*

A pointer to a string that contains all valid characters in the namespace. If the namespace provides any invalid characters in ppwszInvalidChars, then this value returns NULL. See Remarks for more details.

-param ppwszInvalidChars [out]

Type: LPWSTR*

A pointer to a string that contains all invalid characters in the namespace.

-returns

Type: HRESULT

If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

-remarks

As an example, the standard file system returns the string "/:*?"<>|" in ppwszInvalidChars and NULL in ppwszValidChars.

Both parameters cannot return non-NULL values, so ppwszValidChars is assigned a value of NULL because of the non-NULL value

in ppwszInvalidChars. It is assumed that when there are specified invalid characters, everything else is valid. Only when ppwszInvalidChars is NULL does ppwszValidChars contain a list of all valid characters.

If the method returns a success code, the allocated string must be freed using CoTaskMemFree.