StrRetToStrN 함수
IShellFolder::GetDisplayNameOf에서 반환된 STRRET 구조를 사용하여 문자열로 변환하고 결과를 버퍼에 배치합니다.
구문
BOOL StrRetToStrN(
_Out_ LPTSTR pszOut,
_In_ UINT cchOut,
_Inout_ LPSTRRET pStrRet,
_In_ LPCITEMIDLIST pidl
);
매개 변수
-
pszOut [out]
-
형식: LPTSTR
표시 이름을 저장할 버퍼입니다. null로 끝나는 문자열로 반환됩니다. cchOut이 너무 작으면 이름에 맞게 잘립니다.
-
cchOut [in]
-
형식: UINT
pszOut의 크기(문자)입니다. cchOut이 너무 작으면 문자열이 잘리도록 잘립니다.
-
pStrRet [in, out]
-
형식: LPSTRRET
STRRET 구조체에 대한 포인터입니다. 함수가 반환되면 이 포인터는 더 이상 유효하지 않습니다.
-
pidl [in]
-
형식: LPCITEMIDLIST
항목의 ITEMIDLIST 구조에 대한 포인터입니다.
반환 값
형식: BOOL
성공의 경우 TRUE, 실패의 경우 FALSE입니다.
설명
참고
Shell32.dll 버전 5.0을 기준으로 이 함수를 호출하는 것은 StrRetToBuf를 호출하는 것과 같습니다.
StrRetToStrN 은 이름으로 내보내지지 않습니다. 이를 사용하려면 GetProcAddress 를 사용하고 Shell32.dll 서수 96을 요청하여 함수 포인터를 가져와야 합니다.
pStrRet이 가리키는 구조체의 uType 멤버가 STRRET_WSTR 설정되면 반환 시 해당 구조체의 pOleStr 멤버가 해제됩니다.
이 함수는 Shlwapi.dll 아니라 Shell32.dll 내보냅니다. 또한 Shlwapi.h가 아닌 Shlobj.h에 포함되어 있습니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 |
Windows 2000 Professional, Windows XP [데스크톱 앱만 해당] |
| 지원되는 최소 서버 |
Windows 2000 Server[데스크톱 앱만] |
| DLL |
|
추가 정보