IBackgroundCopyQMgr::GetGroup 메서드(qmgr.h)
[IBackgroundCopyQMgr 은 요구 사항 섹션에 지정된 운영 체제에서 사용할 수 있습니다. 이후 버전에서는 변경되거나 제공되지 않을 수 있습니다. 대신 BITS 인터페이스를 사용합니다.]
GetGroup 메서드를 사용하여 다운로드 큐에서 그룹을 검색합니다. 현재 사용자는 자신이 소유한 그룹만 검색할 수 있습니다. 사용자에게 관리자 권한이 있는 경우 사용자는 다운로드 큐에서 모든 그룹을 검색할 수 있습니다. 큐에서 그룹을 검색하면 그룹의 소유권이 현재 사용자에게 전송됩니다.
구문
HRESULT GetGroup(
[in] GUID groupID,
[out] IBackgroundCopyGroup **ppGroup
);
매개 변수
[in] groupID
다운로드 큐에서 그룹을 고유하게 식별하는 GUID입니다.
[out] ppGroup
IBackgroundCopyGroup 인터페이스 포인터에 대한 포인터입니다. 이 인터페이스를 사용하여 그룹을 관리합니다. 예를 들어 그룹에 작업을 추가하고 그룹의 속성을 설정합니다.
반환 값
이 메서드는 다음 HRESULT 값과 다른 값을 반환합니다.
반환 코드 | 설명 |
---|---|
|
그룹을 성공적으로 검색했습니다. |
|
다운로드 큐에서 그룹을 찾을 수 없습니다. |
요구 사항
요구 사항 | 값 |
---|---|
지원되는 최소 클라이언트 | Windows XP |
지원되는 최소 서버 | Windows Server 2003 |
대상 플랫폼 | Windows |
헤더 | qmgr.h |
DLL | QmgrPrxy.dll |