IPrintOemPrintTicketProvider::QueryDeviceDefaultNamespace 메서드(prcomoem.h)
IPrintOemPrintTicketProvider::QueryDeviceDefaultNamespace 메서드는 기본 네임스페이스 URI(Uniform Resource Identifier)에 대해 디바이스를 쿼리합니다.
구문
HRESULT QueryDeviceDefaultNamespace(
[out] OUT BSTR *pbstrNamespaceUri
);
매개 변수
[out] pbstrNamespaceUri
네임스페이스 URI를 수신하는 BSTR에 대한 포인터입니다. 플러그 인은 pbstrNamespaceUri가 가리키는 버퍼에 네임스페이스 URI를 배치합니다. IPrintOemPrintTicketProvider::QueryDeviceDefaultNamespace는 SysAllocString(Microsoft Windows SDK 설명서에 설명됨)을 호출하여 문자열을 할당하는 작업을 담당하지만 호출자는 문자열 해제를 담당합니다.
반환 값
IPrintOemPrintTicketProvider::QueryDeviceDefaultNamespace 는 다음 값 중 하나를 반환해야 합니다.
| 반환 코드 | Description |
|---|---|
| S_OK | 작업에 성공했습니다. |
| E_NOTIMPL | 플러그 인은 핵심 드라이버가 플러그 인 공급자에서 생성한 기본 네임스페이스를 재정의하지 않습니다. |
설명
플러그 인은 코어 드라이버가 GPD 파일 또는 핵심 드라이버에서 인식하지 못하는 PPD 파일에 정의된 기능을 처리하는 데 사용해야 하는 프라이빗 네임스페이스 URI의 이름을 지정해야 합니다. 플러그 인은 IPrintOemPrintTicketProvider::BindPrinter 메서드 호출의 결과로 네임스페이스 집합을 지정할 수 있습니다. IPrintOemPrintTicketProvider::QueryDeviceDefaultNamespace의 목적은 핵심 드라이버에 이러한 네임스페이스 중 기본 네임스페이스로 사용할 네임스페이스를 알리는 것입니다. 핵심 드라이버는 인식할 수 없는 모든 기능을 이 기본 네임스페이스와 연결하고 이러한 기능을 인쇄 티켓에 배치합니다.
IPrintOemPrintTicketProvider::QueryDeviceDefaultNamespace가 반환되면 핵심 드라이버는 플러그 인이 지정한 프라이빗 네임스페이스 URI(*pbstrNamespaceUri)를 DOM 문서의 루트 노드에 추가할 책임이 있습니다. 또한 핵심 드라이버는 플러그 인이 플러그 인의 프라이빗 네임스페이스 아래에 인쇄 티켓에 새 노드를 추가할 때 플러그 인이 사용해야 하는 프라이빗 네임스페이스에 대한 접두사를 정의해야 합니다. 플러그 인은 이 기본 프라이빗 네임스페이스 URI에 대한 자체 접두사를 정의해서는 안 됩니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 대상 플랫폼 | 데스크톱 |
| 머리글 | prcomoem.h(Prcomoem.h 포함) |