IWSDDeviceHost::RetireService 메서드(wsdhost.h)
RegisterService를 사용하여 등록된 서비스 개체의 등록을 취소하고 디바이스 호스트 메타데이터에서 서비스를 제거합니다.
구문
HRESULT RetireService(
[in] LPCWSTR pszServiceId
);
매개 변수
[in] pszServiceId
제거할 서비스의 ID입니다.
반환 값
가능한 반환 값에는 다음이 포함되지만 이에 국한되지는 않습니다.
반환 코드 | Description |
---|---|
|
메서드가 성공적으로 완료되었습니다. |
|
pszServiceId 는 NULL입니다. |
|
pszServiceId의 문자 길이가 WSD_MAX_TEXT_LENGTH(8192)를 초과하거나 등록된 서비스 목록에서 pszServiceId를 찾을 수 없습니다. |
|
메서드가 실패했습니다. 호스트가 초기화되지 않았기 때문에 실패했을 수 있습니다. Init를 호출하여 디바이스 호스트를 초기화합니다. |
설명
디바이스 호스트는 서비스가 등록 취소된 후 서비스 개체에 대한 참조를 해제합니다. 서비스 개체는 RetireService 가 완료된 후 콜백을 받지 않습니다.
요구 사항
요구 사항 | 값 |
---|---|
지원되는 최소 클라이언트 | Windows Vista [데스크톱 앱만 해당] |
지원되는 최소 서버 | Windows Server 2008 [데스크톱 앱만 해당] |
대상 플랫폼 | Windows |
헤더 | wsdhost.h(Wsdapi.h 포함) |
DLL | Wsdapi.dll |