SHCreateItemInKnownFolder 함수(shobjidl_core.h)

알려진 폴더 내에 있는 단일 파일에 대한 Shell 항목 개체를 만듭니다.

구문

SHSTDAPI SHCreateItemInKnownFolder(
  [in]           REFKNOWNFOLDERID kfid,
                 DWORD            dwKFFlags,
  [in, optional] PCWSTR           pszItem,
  [in]           REFIID           riid,
  [out]          void             **ppv
);

매개 변수

[in] kfid

형식: REFKNOWNFOLDERID

항목을 포함하는 폴더를 식별하는 GUID인 KNOWNFOLDERID에 대한 참조입니다.

dwKFFlags

형식:DWORD

개체 검색에서 특수 옵션을 지정하는 플래그입니다. 이 값은 0일 수 있습니다. 그렇지 않으면 하나 이상의 KNOWN_FOLDER_FLAG 값입니다.

[in, optional] pszItem

형식: PCWSTR

새 항목의 파일 이름을 유니코드 문자열로 포함하는 null로 끝나는 버퍼에 대한 포인터입니다. 이 매개 변수는 NULL일 수도 있습니다. 이 경우 알려진 폴더 자체를 나타내는 IShellItem 이 만들어집니다.

[in] riid

형식: REFIID

ppv를 통해 검색된 항목을 나타내는 인터페이스의 IID에 대한 참조입니다. 이 값은 일반적으로 IID_IShellItem 또는 IID_IShellItem2.

[out] ppv

형식: void**

이 함수가 성공적으로 반환되면 는 riid에서 요청된 인터페이스 포인터를 포함합니다. 일반적으로 IShellItem 또는 IShellItem2입니다.

반환 값

형식: HRESULT

이 함수가 성공하면 S_OK 반환합니다. 성공하지 않으면 HRESULT 오류 코드를 반환합니다.

요구 사항

추가 정보

알려진 폴더 샘플