StrRetToBSTR 함수(shlwapi.h)

문자열을 포함하거나 가리키는 IShellFolder::GetDisplayNameOf에서 반환된 STRRET 구조를 수락하고 해당 문자열을 BSTR로 반환합니다.

구문

LWSTDAPI StrRetToBSTR(
  [in, out] STRRET          *pstr,
  [in]      PCUITEMID_CHILD pidl,
  [out]     BSTR            *pbstr
);

[in, out] pstr

형식: STRRET*

STRRET 구조체에 대한 포인터입니다. 함수가 반환되면 이 포인터가 더 오래 유효합니다.

[in] pidl

형식: PCUITEMID_CHILD

부모 폴더를 기준으로 파일 개체 또는 하위 폴더를 고유하게 식별하는 ITEMIDLIST 에 대한 포인터입니다. 이 값은 NULL일 수 있습니다.

[out] pbstr

형식: BSTR*

변환된 문자열을 수신하는 BSTR 형식의 변수에 대한 포인터입니다.

형식: HRESULT

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

pstr에서 가리키는 STRRET 구조체의 uType 멤버가 STRRET_WSTR 설정되면 반환 시 해당 구조체의 pOleStr 멤버가 해제됩니다.