다음을 통해 공유

IItemNameLimits::GetValidCharacters 메서드(shobjidl_core.h)

  • 아티클

호출되는 네임스페이스에서 유효하거나 잘못된 각 문자가 포함된 문자열을 로드합니다.

구문

HRESULT GetValidCharacters(
  [out] LPWSTR *ppwszValidChars,
  [out] LPWSTR *ppwszInvalidChars
);

매개 변수

[out] ppwszValidChars

형식: LPWSTR*

네임스페이스의 모든 유효한 문자를 포함하는 문자열에 대한 포인터입니다. 네임스페이스가 ppwszInvalidChars에 잘못된 문자를 제공하는 경우 이 값은 NULL을 반환합니다. 자세한 내용은 비고를 참조하세요.

[out] ppwszInvalidChars

형식: LPWSTR*

네임스페이스의 모든 잘못된 문자가 포함된 문자열에 대한 포인터입니다.

반환 값

형식: HRESULT

메서드가 성공하면 S_OK를 반환하고, 그러지 않으면 HRESULT 오류 코드를 반환합니다.

설명

예를 들어 표준 파일 시스템은 "/:*?"<>|" 문자열을 반환합니다. in ppwszInvalidChars 및 NULL in ppwszValidChars.

두 매개 변수 모두 비 NULL 값을 반환할 수 없으므로 NULL이 아닌 값으로 인해 ppwszValidChars에 NULL 값이 할당됩니다.

ppwszInvalidChars에서 잘못된 문자가 지정된 경우 다른 모든 문자가 유효하다고 가정합니다. ppwszInvalidChars가 NULL인 경우에만 ppwszValidChars에 유효한 모든 문자 목록이 포함됩니다.

메서드가 성공 코드를 반환하는 경우 CoTaskMemFree를 사용하여 할당된 문자열을 해제해야 합니다.

요구 사항

   
지원되는 최소 클라이언트 Windows XP [데스크톱 앱만 해당]
지원되는 최소 서버 Windows Server 2003 [데스크톱 앱만 해당]
대상 플랫폼 Windows
헤더 shobjidl_core.h(Shobjidl.h 포함)
DLL Shell32.dll