IBackgroundCopyJob::SetDisplayName 메서드(bits.h)

작업의 표시 이름을 지정합니다. 일반적으로 표시 이름을 사용하여 사용자 인터페이스에서 작업을 식별합니다.

구문

HRESULT SetDisplayName(
  [in] LPCWSTR Val
);

[in] Val

작업을 식별하는 Null로 끝나는 문자열입니다. NULL이 아니어야 합니다. 문자열의 길이는 null 종결자를 포함하지 않고 256자로 제한됩니다.

이 메서드는 다음 HRESULT 값과 다른 값을 반환합니다.

반환 코드	설명
S_OK	표시 이름이 설정되었습니다.
E_INVALIDARG	pDisplayName 매개 변수는 NULL일 수 없거나 이름이 256자를 초과합니다.
BG_E_STRING_TOO_LONG	표시 이름이 256자를 초과합니다.
BG_E_INVALID_STATE	작업의 상태는 BG_JOB_STATE_CANCELLED 또는 BG_JOB_STATE_ACKNOWLEDGED 수 없습니다.

표시 이름은 원래 작업을 만들 때 설정됩니다. 작업을 만들 때 표시 이름을 지정하는 방법에 대한 자세한 내용은 IBackgroundCopyManager::CreateJob 메서드를 참조하세요.