SHPathPrepareForWriteW 함수(shlobj_core.h)

아티클
08/26/2023

경로가 있는지 확인합니다. 여기에는 매핑된 네트워크 드라이브를 다시 탑재하고, 꺼내기 가능한 미디어를 다시 삽입하라는 메시지를 표시하고, 경로를 만들고, 미디어의 형식을 지정하라는 메시지를 표시하고, 필요한 경우 적절한 사용자 인터페이스를 제공하는 것이 포함됩니다. 매체에 대한 읽기/쓰기 권한이 선택되지 않습니다.

구문

SHSTDAPI SHPathPrepareForWriteW(
  [in, optional] HWND     hwnd,
  [in, optional] IUnknown *punkEnableModless,
  [in]           LPCWSTR  pszPath,
                 DWORD    dwFlags
);

매개 변수

[in, optional] hwnd

형식: HWND

만들어야 하는 모든 사용자 인터페이스 창에 사용할 부모 창을 지정하는 창에 대한 핸들입니다. NULL로 설정하면 사용자 인터페이스 창이 만들어지지 않습니다.

[in, optional] punkEnableModless

형식: IUnknown*

EnableModeless 메서드를 구현하는 IOleInPlaceActiveObject 개체를 지정하는 IUnknown 인터페이스에 대한 포인터입니다.

[in] pszPath

형식: LPCTSTR

쓰기에 유효한 것으로 확인할 경로를 지정하는 최대 길이 MAX_PATH null로 끝나는 문자열에 대한 포인터입니다. UNC 또는 파일 드라이브 경로일 수 있습니다.

dwFlags

형식:DWORD

동작 옵션을 결정하는 플래그입니다. 이 매개 변수는 다음 값의 조합일 수 있습니다.

SHPPFW_NONE

새 디렉터리를 만들지 마세요.

SHPPFW_DEFAULT

기본값 디렉터리를 만들어야 하는 경우 사용자에게 메시지를 표시하지 마세요. 이는 SHPPFW_DIRCREATE 동일합니다. SHPPFW_ASKDIRCREATE 함께 전달하지 마세요.

SHPPFW_DIRCREATE

사용자에게 메시지를 표시하지 않고 디렉터리를 만듭니다. SHPPFW_ASKDIRCREATE 함께 전달하지 마세요.

SHPPFW_ASKDIRCREATE

디렉터리를 만들기 전에 사용자에게 메시지를 표시합니다. SHPPFW_DIRCREATE 함께 전달하지 마세요.

SHPPFW_IGNOREFILENAME

pszPath의 마지막 항목은 파일 이름이므로 무시합니다. 예를 들어 pszPath="C:\MyDir\MyFile.doc"인 경우 "C:\MyDir"만 사용합니다. pszPath="C:\MyFirDir\MySecDir"인 경우 "C:\MyFirDir"만 사용합니다.

SHPPFW_NOWRITECHECK

현재 구현되지 않습니다.

SHPPFW_MEDIACHECKONLY

Windows XP 이상. 사용자 취소 이외의 오류가 발생하고 hwnd 가 NULL이 아닌 경우 표시되는 "액세스할 수 없음" 오류 메시지 상자를 표시하지 않습니다.

반환 값

형식: HRESULT

경로를 사용할 수 있으면 S_OK 반환하고, 그렇지 않으면 오류 코드를 반환합니다. S_OK 반환 값이 매체를 쓸 수 있음을 의미하지는 않습니다. 경로를 사용할 수 있음을 의미합니다.

설명

이 함수의 기본 용도는 프로그램을 사용하기 전에 경로를 검사 사용자에게 메시지를 표시하는 데 필요한 사용자 인터페이스를 표시하는 것입니다. 예를 들어 A: 드라이브의 디스크가 누락된 경우 사용자에게 디스크를 삽입하라는 메시지가 표시되는 창이 나타납니다.

참고

shlobj_core.h 헤더는 UNICODE 전처리기 상수의 정의에 따라 이 함수의 ANSI 또는 유니코드 버전을 자동으로 선택하는 별칭으로 SHPathPrepareForWrite를 정의합니다. 인코딩 중립 별칭을 인코딩 중립이 아닌 코드와 혼합하면 컴파일 또는 런타임 오류가 발생하는 불일치가 발생할 수 있습니다. 자세한 내용은 함수 프로토타입에 대한 규칙을 참조하세요.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버	Windows 2000 Server[데스크톱 앱만]
대상 플랫폼	Windows
헤더	shlobj_core.h(Shlobj.h, Shlobj_core.h 포함)
라이브러리	Shell32.lib
DLL	Shell32.dll(버전 5.0 이상)

다음을 통해 공유