다음을 통해 공유


ITaskFolder::CreateFolder 메서드(taskschd.h)

관련 작업에 대한 폴더를 만듭니다.

통사론

HRESULT CreateFolder(
  [in]  BSTR        subFolderName,
  [in]  VARIANT     sddl,
  [out] ITaskFolder **ppFolder
);

매개 변수

[in] subFolderName

폴더를 식별하는 데 사용되는 이름입니다. "FolderName\SubFolder1\SubFolder2"를 지정하면 폴더가 없으면 전체 폴더 트리가 만들어집니다. 이 매개 변수는 현재 ITaskFolder 인스턴스에 대한 상대 경로일 수 있습니다. 루트 작업 폴더는 백슬래시(\)로 지정됩니다. 루트 작업 폴더 아래에 있는 작업 폴더 경로의 예는 \MyTaskFolder입니다. '.' 문자를 사용하여 현재 작업 폴더와 '.'을 지정할 수 없습니다. 문자는 경로에서 부모 작업 폴더를 지정하는 데 사용할 수 없습니다.

[in] sddl

SDDL_REVISION_1 형식의 VT_BSTR 형식으로 폴더와 연결된 보안 설명자입니다.

[out] ppFolder

새 하위 폴더를 나타내는 ITaskFolder 인터페이스입니다.

NULLITaskFolder 인터페이스 포인터에 대한 참조를 전달합니다. NULL 포인터를 참조하면 포인터를 덮어쓰기 때문에 메모리 누수가 발생할 수 있습니다.

반환 값

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

발언

부모 폴더의 하위 폴더를 검색하려면 GetFolders 메서드를 사용합니다.

CreateFolder 메서드는 만들려는 폴더가 이미 있는 경우 0x800700b7 반환합니다.

sddl 매개 변수에 잘못된 보안 설명자를 지정하면 이 메서드가 E_INVALIDARG반환됩니다.

요구 사항

요구
지원되는 최소 클라이언트 Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버 Windows Server 2008 [데스크톱 앱만 해당]
대상 플랫폼 Windows
헤더 taskschd.h
라이브러리 Taskschd.lib
DLL Taskschd.dll

참고 항목

ITaskFolder

작업 스케줄러