영어로 읽기

다음을 통해 공유


UPnP API

UPnP API 기술 개요입니다.

UPnP API를 개발하려면 다음 헤더가 필요합니다.

이 기술에 대한 프로그래밍 지침은 다음을 참조하세요.

Functions

 
중단

Abort 메서드는 IUPnPDescriptionDocument::LoadAsync에서 시작한 비동기 로드 작업을 중지합니다.
AddCallback

AddCallback 메서드는 애플리케이션의 콜백을 UPnP 프레임워크에 등록합니다.
AddRequestHeaders

제공된 HTTP 헤더를 HTTP 요청에 추가합니다.
조언

Advise 메서드는 호스트된 서비스에서 이벤트 수신을 시작하기 위해 디바이스 호스트에서 호출됩니다.
AsyncOperationComplete

AsyncOperationComplete 콜백 메서드는 비동기 I/O 작업의 완료에 대한 알림을 제공합니다.
BeginInvokeAction

BeginInvokeAction 메서드는 비동기 모드에서 디바이스에서 작업을 호출합니다. 또한 지연된 SCPD 다운로드 및 이벤트 구독이 옵트인되고 아직 수행되지 않은 경우 이 메서드는 SCPD 다운로드를 시작합니다.
BeginQueryStateVariable

BeginQueryStateVariable 메서드는 특정 서비스의 상태 변수 값에 대한 비동기 요청을 시작합니다.
BeginSCPDDownload

BeginSCPDDownload 메서드는 SCPD(서비스 제어 프로토콜 설명) 문서의 비동기 다운로드를 시작합니다.
BeginSubscribeToEvents

BeginSubscribeToEvents는 비동기 모드에서 이벤트 구독을 시작하고 UPnP 프레임워크에 애플리케이션 콜백을 등록합니다.
CancelAsyncFind

CancelAsyncFind 메서드는 비동기 검색을 취소합니다.
CancelAsyncOperation

CancelAsyncOperation 메서드는 BeginInvokeAction, BeginQueryStateVariable, BeginSubscribeToEvents 또는 BeginSCPDDownload 메서드에 의해 시작된 보류 중인 비동기 작업을 취소합니다.
CreateAsyncFind

CreateAsyncFind 메서드는 비동기 검색 작업을 만듭니다.
DeviceAdded

DeviceAdded 메서드는 UPnP 프레임워크에서 호출되어 디바이스가 네트워크에 추가되었음을 애플리케이션에 알립니다.
DeviceAddedWithInterface

DeviceAddedWithInterface 메서드는 UPnP 프레임워크에서 호출되어 디바이스가 네트워크에 추가되었음을 애플리케이션에 알립니다.
DeviceByUDN

DeviceByUDN 메서드는 로드된 설명 문서에 포함된 지정된 UDN(고유 디바이스 이름)을 사용하여 디바이스를 반환합니다.
DeviceRemoved

DeviceRemoved 메서드는 UPnP 프레임워크에서 호출되어 네트워크에서 디바이스가 제거되었음을 애플리케이션에 알립니다.
EndInvokeAction

EndInvokeAction 메서드는 이전 BeginInvokeAction 작업의 결과를 검색하고 결과 출력 인수를 검색합니다.
EndQueryStateVariable

EndQueryStateVariable 메서드는 이전 BeginQueryStateVariable 작업의 결과를 검색하고 결과 서비스별 상태 변수 값을 검색합니다.
EndSCPDDownload

EndSCPDDownload 메서드는 SCPD(서비스 제어 프로토콜 설명) 문서의 이전 비동기 다운로드 결과를 검색합니다.
EndSubscribeToEvents

EndSubscribeToEvents 메서드는 이전 BeginSubscribeToEvents 작업의 결과를 검색합니다.
FindByType

FindByType 메서드는 디바이스 유형 또는 서비스 유형별로 디바이스를 동기적으로 검색합니다.
FindByUDN

FindByUDN 메서드는 고유한 UDN(디바이스 이름)으로 디바이스를 동기적으로 검색합니다.
get__NewEnum

_NewEnum 속성은 컬렉션에 대한 IEnumVARIANT 또는 IEnumUnknown 열거자 인터페이스를 지정합니다. (IUPnPDevices.get__NewEnum)
get__NewEnum

_NewEnum 속성은 컬렉션에 대한 IEnumVARIANT 또는 IEnumUnknown 열거자 인터페이스를 지정합니다. (IUPnPServices.get__NewEnum)
get_Children

Children 속성은 디바이스의 모든 자식 디바이스를 지정합니다. 디바이스는 IUPnPDevices 컬렉션에 저장됩니다.
get_Count

Count 속성은 컬렉션의 디바이스 수를 지정합니다.
get_Count

Count 속성은 컬렉션의 서비스 수를 지정합니다.
get_Description

Description 속성은 디바이스 기능에 대한 사람이 읽을 수 있는 요약을 지정합니다.
get_FriendlyName

FriendlyName 속성은 디바이스의 디바이스 표시 이름을 지정합니다.
get_HasChildren

HasChildren 속성은 디바이스에 자식 디바이스가 있는지 여부를 지정합니다.
get_Id

Id 속성은 서비스의 서비스 ID를 지정합니다.
get_IsRootDevice

IsRootDevice 속성은 디바이스가 디바이스 트리에서 가장 상위 디바이스인지 여부를 지정합니다.
get_Item

Item 속성은 컬렉션에서 UDN으로 식별되는 디바이스에 대한 IUPnPDevice 인터페이스를 지정합니다.
get_Item

Item 속성은 컬렉션에서 서비스 ID로 식별되는 서비스에 대한 IUPnPService 인터페이스를 지정합니다.
get_LastTransportStatus

이벤트 변수와 관련된 쿼리의 경우 LastTransportStatus 속성은 마지막 IUPnPService::InvokeAction 작업의 HTTP 상태 지정합니다.
get_LoadResult

LoadResult 속성은 완료된 로드 작업의 성공 또는 실패 코드를 지정합니다.
get_ManufacturerName

ManufacturerName 속성은 사람이 읽을 수 있는 디바이스의 제조업체 이름 형식을 지정합니다.
get_ManufacturerURL

ManufacturerURL 속성은 제조업체 웹 사이트의 URL을 지정합니다.
get_ModelName

ModelName 속성은 사람이 읽을 수 있는 디바이스의 모델 이름 형식을 지정합니다.
get_ModelNumber

ModelNumber 속성은 사람이 읽을 수 있는 디바이스의 모델 번호 형식을 지정합니다.
get_ModelURL

ModelURL 속성은 디바이스에 대한 모델별 정보를 포함하는 웹 페이지의 URL을 지정합니다.
get_ParentDevice

ParentDevice 속성은 디바이스의 부모를 지정합니다.
get_PresentationURL

PresentationURL 속성은 디바이스를 제어하는 웹 페이지의 프레젠테이션 URL을 지정합니다.
get_ReadyState

ReadyState 속성은 문서 로드 작업의 상태 지정합니다.
get_RootDevice

RootDevice 속성은 디바이스 트리에서 최상위 디바이스를 지정합니다. 루트 디바이스는 물리적 개체를 나타냅니다.
get_SerialNumber

SerialNumber 속성은 사람이 읽을 수 있는 디바이스 일련 번호 형식을 지정합니다.
get_Services

Services 속성은 디바이스에서 제공하는 서비스 목록을 지정합니다.
get_ServiceTypeIdentifier

ServiceTypeIdentifier 속성은 디바이스의 서비스 유형 식별자를 지정합니다.
get_Type

Type 메서드는 디바이스에 대한 디바이스 유형 URI(Uniform Resource Identifier)를 지정합니다.
get_UniqueDeviceName

UniqueDeviceName 속성은 디바이스의 고유한 UDN(디바이스 이름)을 지정합니다. UDN은 고유합니다. 두 디바이스가 동일한 UDN을 가질 수 없습니다.
get_UPC

UPC 속성은 사람이 읽을 수 있는 제품 코드 형식을 지정합니다.
GetAddressFamily

GetAddressFamily 메서드는 Device Finder 개체의 주소 패밀리 플래그의 현재 값을 검색합니다.
GetDocument

UPnP 디바이스에 대한 XML 디바이스 설명 문서를 검색합니다.
GetDocument

GetDocument 메서드는 서비스 개체에 대한 SCPD(서비스 제어 프로토콜 설명) 문서를 검색합니다.
GetDocumentURL

GetDocumentURL 메서드는 디바이스 설명 문서를 로드할 수 있는 URL을 반환합니다.
GetDocumentURL

GetDocumentURL 메서드는 서비스 개체에 대한 SCPD(서비스 제어 프로토콜 설명) URL을 검색합니다. UPnP 제어점은 이 URL을 사용하여 전체 SCPD 문서를 다운로드할 수 있습니다.
GetDwordValue

GetDwordValue 메서드는 요청 또는 요청자에 대한 정보를 제공하는 4 바이트 값을 가져옵니다.
GetGuidValue

GetGuidValue 메서드는 현재 지원되지 않습니다.
GetServiceObject

GetServiceObject 메서드는 특정 서비스 개체에 대한 IDispatch 포인터를 가져오는 데 사용됩니다. 디바이스 호스트는 서비스에 대한 요청을 처음 수신할 때 서비스당 한 번 이 메서드를 호출합니다.
GetStringValue

GetStringValue 메서드는 요청 또는 요청자에 대한 정보를 제공하는 문자열을 가져옵니다.
GetUniqueDeviceName

GetUniqueDeviceName 메서드는 지정된 디바이스에 대한 UDN을 검색합니다.
IconURL

IconURL 메서드는 지정된 형식의 아이콘을 로드할 수 있는 URL을 반환합니다.
초기화

Initialize 메서드는 디바이스를 초기화하는 데 사용됩니다. 디바이스 호스트는 이 메서드를 호출합니다.
InvokeAction

디바이스에서 메서드를 호출합니다.
로드

Load 메서드는 문서를 동기적으로 로드합니다. 이 메서드는 부하 작업이 완료될 때까지 호출자에게 컨트롤을 반환하지 않습니다.
Loadasync

LoadAsync 메서드는 문서를 비동기적으로 로드합니다. 이 메서드는 호출자에게 컨트롤을 즉시 반환하고 지정된 콜백을 사용하여 작업이 완료되면 호출자에게 알립니다.
LoadComplete

LoadComplete 메서드는 UPnP 프레임워크가 디바이스 설명 로드를 완료했을 때 호출됩니다.
OnStateChanged

OnStateChanged 메서드는 변경된 상태 변수의 DISPID 목록이 있는 이벤트를 디바이스 호스트로 보냅니다. 디바이스 호스트는 서비스 개체를 쿼리하여 변경된 각 상태 변수에 대한 새 값을 가져와야 합니다.
OnStateChangedSafe

OnStateChangedSafe 메서드는 변경된 DISPID 목록을 사용하여 이벤트를 디바이스 호스트로 보냅니다. 디바이스 호스트는 서비스 개체를 쿼리하여 변경된 각 상태 변수에 대한 새 값을 가져와야 합니다.
QueryStateVariable

QueryStateVariable 메서드는 지정된 서비스의 상태 변수 값을 반환합니다.
RegisterDevice

RegisterDevice 메서드는 디바이스 호스트에 디바이스를 등록합니다. 디바이스 정보는 디바이스 호스트에 의해 저장됩니다. 그런 다음 디바이스 호스트는 디바이스 식별자를 반환하고 네트워크에서 디바이스를 게시하고 알릴 수 있습니다.
RegisterDeviceProvider

RegisterDeviceProvider 메서드는 디바이스 호스트에 디바이스 공급자를 등록합니다. 디바이스 공급자가 네트워크에 게시되지 않습니다. 대신 디바이스를 동적으로 만들고 RegisterRunningDevice를 사용하여 등록합니다.
RegisterRunningDevice

RegisterRunningDevice 메서드는 실행 중인 디바이스를 디바이스 호스트에 등록합니다.
ReregisterDevice

ReregisterDevice 메서드는 디바이스 호스트에 디바이스를 다시 등록합니다. 디바이스 정보는 디바이스 호스트에 의해 저장됩니다. 그런 다음 디바이스 호스트는 디바이스 식별자를 반환하고 네트워크에서 디바이스를 게시하고 알릴 수 있습니다.
ReregisterRunningDevice

ReregisterRunningDevice 메서드는 실행 중인 디바이스를 디바이스 호스트에 다시 등록합니다.
RootDevice

RootDevice 메서드는 현재 로드된 문서의 디바이스 트리의 루트 디바이스를 반환합니다.
SearchComplete

SearchComplete 메서드는 UPnP 프레임워크에서 호출되어 네트워크 디바이스에 대한 초기 검색이 완료되었음을 애플리케이션에 알립니다.
ServiceInstanceDied

ServiceInstanceDied 메서드는 서비스가 더 이상 이벤트를 보내지 않을 때 호출됩니다.
SetAddressFamily

SetAddressFamily 메서드는 Device Finder 개체의 주소 패밀리 플래그를 설정합니다. 이 플래그는 이 플래그를 사용하여 찾은 디바이스를 필터링합니다.
SetServiceEnumProperty

SetServiceEnumProperty 메서드는 IUPnPServices 개체에서 열거된 IUPnPService 개체에 대해 지연된 SCPD(서비스 제어 프로토콜 설명) 다운로드 및 이벤트 구독에 대한 옵트인을 나타내는 데 사용됩니다.
시작

Start 메서드는 디바이스 공급자를 시작합니다. 디바이스 호스트는 디바이스 공급자를 로드한 후 이 메서드를 호출합니다. 이 메서드는 디바이스 공급자에 필요한 모든 초기화를 수행합니다.
StartAsyncFind

StartAsyncFind 메서드는 비동기 검색 작업을 시작합니다.
StateVariableChanged

StateVariableChanged 메서드는 상태 변수가 변경될 때 호출됩니다.
중지

Stop 메서드는 디바이스 공급자를 중지합니다.
Unadvise

Unadvise 메서드는 이벤트 수신을 중지하기 위해 디바이스 호스트에서 호출됩니다. 디바이스 호스트는 IUPnPEventSource::Advise 메서드를 호출할 때와 동일한 포인터를 전달합니다.
UnregisterDevice

UnregisterDevice 메서드는 디바이스 호스트에서 디바이스의 등록을 취소합니다. 디바이스가 일시적으로 또는 영구적으로 등록 취소되었습니다.
UnregisterDeviceProvider

UnregisterDeviceProvider 메서드는 디바이스 호스트에서 디바이스 공급자의 등록을 영구적으로 취소하고 언로드합니다. IUPnPDeviceProvider::Stop 메서드가 호출됩니다.

인터페이스

 
IUPnPAddressFamilyControl

IUPnPAddressFamilyControl 인터페이스는 Device Finder 개체의 주소 패밀리 플래그에 액세스합니다.
IUPnPAsyncResult

IUPnPAsyncResult 인터페이스는 완료된 비동기 I/O 작업의 UPnP 제어 지점에 알리는 데 사용됩니다.
IUPnPDescriptionDocument

IUPnPDescriptionDocument 인터페이스를 사용하면 애플리케이션이 디바이스 설명을 로드할 수 있습니다.
IUPnPDescriptionDocumentCallback

IUPnPDescriptionDocumentCallback 인터페이스를 사용하면 UPnP 프레임워크가 비동기 로드 작업의 결과를 애플리케이션에 전달할 수 있습니다.
IUPnPDevice

IUPnPDevice 인터페이스를 사용하면 애플리케이션이 특정 디바이스에 대한 정보를 검색할 수 있습니다.
IUPnPDeviceControl

IUPnPDeviceControl 인터페이스는 디바이스 및 해당 서비스 개체에 대한 관리의 중심 지점입니다.
IUPnPDeviceDocumentAccess

IUPnPDeviceDocumentAccess 인터페이스를 사용하면 애플리케이션이 디바이스 설명 문서의 URL을 가져올 수 있습니다.
IUPnPDeviceDocumentAccessEx

특정 디바이스에 대한 전체 XML 디바이스 설명 문서를 가져오는 메서드를 제공합니다.
IUPnPDeviceFinder

IUPnPDeviceFinder 인터페이스를 사용하면 애플리케이션에서 디바이스를 찾을 수 있습니다.
IUPnPDeviceFinderAddCallbackWithInterface

IUPnPDeviceFinderAddCallbackWithInterface 인터페이스를 사용하면 UPnP 프레임워크가 애플리케이션과 통신할 수 있습니다.
IUPnPDeviceFinderCallback

IUPnPDeviceFinderCallback 인터페이스를 사용하면 UPnP 프레임워크가 비동기 검색 결과를 애플리케이션에 전달할 수 있습니다.
IUPnPDeviceProvider

IUPnPDeviceProvider 인터페이스를 사용하면 디바이스 공급자가 해당 처리를 시작하고 중지할 수 있습니다.
IUPnPDevices

IUPnPDevices 인터페이스는 디바이스 컬렉션을 열거합니다.
IUPnPEventSink

IUPnPEventSink 인터페이스를 사용하면 호스트된 서비스가 디바이스 호스트에 이벤트 알림을 보낼 수 있습니다.
IUPnPEventSource

IUPnPEventSource 인터페이스를 사용하면 디바이스 호스트가 호스트된 서비스에 대한 이벤트 구독을 관리할 수 있습니다.
IUPnPHttpHeaderControl

호출자가 디바이스에 대한 HTTP 요청에서 전송된 추가 HTTP 헤더를 지정할 수 있도록 합니다.
IUPnPRegistrar

IUPnPRegistrar 인터페이스는 디바이스 호스트의 컨텍스트에서 실행되는 디바이스를 등록합니다.
IUPnPRemoteEndpointInfo

IUPnPRemoteEndpointInfo 인터페이스를 사용하면 호스트된 디바이스가 요청자(즉, 제어점) 및 요청에 대한 정보를 가져올 수 있습니다.
IUPnPReregistrar

IUPnPReregistrar 인터페이스를 사용하면 애플리케이션이 디바이스 호스트에 UPnP 기반 디바이스를 다시 등록할 수 있습니다.
IUPnPService

IUPnPService 인터페이스를 사용하면 애플리케이션이 상태 변수를 쿼리하고 서비스의 instance 작업을 호출할 수 있습니다.
IUPnPServiceAsync

이 인터페이스를 사용하여 상태 변수를 비동기적으로 쿼리하고 서비스의 instance 작업을 호출합니다.
IUPnPServiceCallback

IUPnPServiceCallback 인터페이스는 서비스 개체의 클라이언트에 이벤트 알림을 보내는 데 사용됩니다.
IUPnPServiceDocumentAccess

이 인터페이스를 사용하여 SCPD(서비스 제어 프로토콜 설명) 문서를 검색하여 UPnP 제어 지점 애플리케이션에 제공하여 서비스에서 지원하는 작업을 노출하고 상태 변수에 대한 정보를 제공합니다.
IUPnPServiceEnumProperty

이 인터페이스를 사용하여 IUPnPServices 개체에서 열거된 IUPnPService 개체에서 SCPD(서비스 제어 프로토콜 설명) 다운로드 및 이벤트 구독을 지연할 수 있습니다.
IUPnPServices

IUPnPServices 인터페이스는 서비스 컬렉션을 열거합니다.