IAttachmentExecute::SetFileName 메서드(shobjidl_core.h)

파일의 제안된 이름을 지정하고 저장합니다.

구문

HRESULT SetFileName(
  [in] LPCWSTR pszFileName
);

[in] pszFileName

형식: LPCWSTR

파일 이름을 포함하는 문자열에 대한 포인터입니다.

형식: HRESULT

메서드가 성공하면 S_OK를 반환하고, 그렇지 않으면 다음을 포함하여 HRESULT 오류 코드를 반환합니다.

반환 코드	설명
E_INVALIDARG	pszFileName 값은 NULL로 설정되거나, 빈 문자열을 가리키거나, MAX_PATH 보다 긴 파일 이름을 가리킵니다.
E_UNEXPECTED	파일 이름을 저장할 수 없습니다.

pszFileName에는 경로 정보가 포함되지 않아야 하며 파일 이름만 포함됩니다.

IAttachmentExecute::SetFileName은 호출 애플리케이션에서 파일을 로컬로 복사하기 전에 파일 이름의 유효성을 검사 데 사용할 수 있습니다. 파일 이름은 로컬 경로 위치에 저장된 다른 파일과의 이름 충돌을 확인합니다.

IAttachmentExecute::SetFileName 은 선택 사항입니다.