IFileOperation::NewItem 메서드(shobjidl_core.h)

지정된 위치에 만들 새 항목을 선언합니다.

구문

HRESULT NewItem(
  [in] IShellItem                 *psiDestinationFolder,
  [in] DWORD                      dwFileAttributes,
  [in] LPCWSTR                    pszName,
  [in] LPCWSTR                    pszTemplateName,
  [in] IFileOperationProgressSink *pfopsItem
);

매개 변수

[in] psiDestinationFolder

형식: IShellItem*

새 항목을 포함할 대상 폴더를 지정하는 IShellItem 에 대한 포인터입니다.

[in] dwFileAttributes

형식:DWORD

파일 또는 폴더의 파일 시스템 특성을 지정하는 비트 값입니다. 가능한 값 은 GetFileAttributes 를 참조하세요.

[in] pszName

형식: LPCWSTR

instanceNewfile.txt의 새 항목의 파일 이름에 대한 포인터 입니다. null로 끝나는 유니코드 문자열입니다.

[in] pszTemplateName

형식: LPCWSTR

새 항목이 기반으로 하는 템플릿 파일의 이름(예: Excel9.xls)에 대한 포인터로, 다음 위치 중 하나에 저장됩니다.

• CSIDL_COMMON_TEMPLATES. 이 폴더의 기본 경로는 %ALLUSERSPROFILE%\Templates입니다.
• CSIDL_TEMPLATES. 이 폴더의 기본 경로는 %USERPROFILE%\Templates입니다.
• %SystemRoot%\shellnew

애플리케이션이 새 파일에 포함하려는 최소한의 콘텐츠를 포함하는 새 파일과 동일한 형식의 기존 파일을 지정하는 데 사용되는 null로 끝나는 유니코드 문자열입니다.

이 매개 변수는 일반적으로 새 빈 파일을 지정하는 NULL 입니다.

[in] pfopsItem

형식: IFileOperationProgressSink*

상태 및 실패 알림에 사용할 IFileOperationProgressSink 개체에 대한 포인터입니다. 전체 작업에 대해 IFileOperation::Advise를 호출하면 만들기 작업에 대한 진행률 상태 및 오류 알림이 포함되므로 이 매개 변수를 NULL로 설정합니다.

반환 값

형식: HRESULT

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

설명

이 메서드는 새 항목을 만들지 않고 만들려는 항목만 선언합니다. 새 항목을 만들려면 적어도 여기에 자세히 설명된 호출 시퀀스를 만들어야 합니다.

1. IFileOperation::NewItem을 호출하여 새 파일 또는 폴더의 세부 정보를 선언합니다.
2. IFileOperation::P erformOperations를 호출하여 새 항목을 만듭니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2008 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	shobjidl_core.h(Shobjidl.h 포함)

추가 정보

IFileOperation

PostNewItem

PreNewItem