IFileOperationProgressSink::P ostNewItem 메서드(shobjidl_core.h)

새 항목을 만든 후 호출자가 구현한 작업을 수행합니다.

구문

HRESULT PostNewItem(
  [in] DWORD      dwFlags,
  [in] IShellItem *psiDestinationFolder,
  [in] LPCWSTR    pszNewName,
  [in] LPCWSTR    pszTemplateName,
  [in] DWORD      dwFileAttributes,
  [in] HRESULT    hrNew,
  [in] IShellItem *psiNewItem
);

매개 변수

[in] dwFlags

형식:DWORD

생성 작업 중에 사용된 플래그를 포함하는 비트 값입니다. 일부 값은 생성 작업 중에 설정하거나 변경할 수 있습니다. 플래그 설명은 TRANSFER_SOURCE_FLAGS 참조하세요.

[in] psiDestinationFolder

형식: IShellItem*

새 항목이 추가된 대상 폴더를 지정하는 IShellItem 에 대한 포인터입니다.

[in] pszNewName

형식: LPCWSTR

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

[in] pszTemplateName

형식: LPCWSTR

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

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

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

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

[in] dwFileAttributes

형식:DWORD

새 항목에 적용된 파일 특성입니다. GetFileAttributes에 있는 하나 이상의 값입니다.

[in] hrNew

형식: HRESULT

만들기 작업의 반환 값입니다. 새로 만들기 작업을 큐에 대기시키는 NewItem에서 반환한 HRESULT가 아닙니다. 대신 실제 생성의 결과입니다.

[in] psiNewItem

형식: IShellItem*

새 항목을 나타내는 IShellItem 에 대한 포인터입니다.

반환 값

형식: HRESULT

성공하면 S_OK 반환하고, 그렇지 않으면 오류 값을 반환합니다. 오류 값의 경우 IFileOperation 호출에서 보류 중인 모든 후속 작업이 취소됩니다.

요구 사항

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