IPrintCoreUI2::SetOptions 메서드(prcomoem.h)

아티클
08/07/2023

메서드는 IPrintCoreUI2::SetOptions 드라이버의 기능 설정을 설정합니다.

구문

HRESULT SetOptions(
  [in]  POEMUIOBJ poemuiobj,
  [in]  DWORD     dwFlags,
  [in]  PCZZSTR   pmszFeatureOptionBuf,
  [in]  DWORD     cbIn,
  [out] PDWORD    pdwResult
);

매개 변수

[in] poemuiobj

현재 컨텍스트인 OEMUIOBJ 구조체에 대한 포인터입니다.

[in] dwFlags

핵심 드라이버가 충돌을 resolve 여부를 지정합니다. 이 매개 변수는 다음 값 중 하나로 설정해야 합니다.

값	의미
SETOPTIONS_FLAG_KEEP_CONFLICT	핵심 드라이버에 발생하는 충돌을 resolve 않도록 요청합니다.
SETOPTIONS_FLAG_RESOLVE_CONFLICT	핵심 드라이버에 발생하는 충돌을 resolve 요청합니다.

[in] pmszFeatureOptionBuf

MULTI_SZ 형식의 기능/옵션 키워드(keyword) 쌍 목록을 포함하는 호출자 제공 버퍼에 대한 포인터입니다. 이 목록의 각 항목은 다음 항목과 null 문자로 구분되고 목록은 두 개의 null 문자로 종료됩니다.

[in] cbIn

pmszFeatureOptionBuf가 가리키는 버퍼의 크기(바이트)를 지정합니다. 이 크기에는 마지막 MULTI_SZ null 문자가 포함됩니다.

[out] pdwResult

다음 값 중 하나를 수신하는 메모리 위치에 대한 포인터입니다. 이러한 상수는 printoem.h에 정의되어 있습니다.

값	의미
SETOPTIONS_RESULT_CONFLICT_REMAINED	핵심 드라이버는 충돌을 발견했지만 해결되지 않은 상태로 남아 있습니다.
SETOPTIONS_RESULT_CONFLICT_RESOLVED	핵심 드라이버는 모든 충돌을 찾아 해결했습니다.
SETOPTIONS_RESULT_NO_CONFLICT	핵심 드라이버가 충돌을 찾지 못했습니다.

반환 값

메서드는 다음 값 중 하나를 반환해야 합니다.

반환 코드	Description
S_OK	메서드가 성공했습니다.
E_NOTIMPL	메서드가 지원되지 않습니다. dwLevel에 지정된 형식의 구조는 지원되지 않습니다.
E_INVALIDARG	dwFlags의 값이 잘못되었습니다. pmszFeatureOptionBuf에서 가리키는 입력 버퍼가 MULTI_SZ 형식이 아닙니다. poemuiobj 매개 변수가 잘못된 컨텍스트 개체를 가리켰습니다.
E_FAIL	메서드가 실패했습니다.

설명

이 메서드는 Windows XP Pscript5 플러그 인에만 지원되며 Unidrv 플러그 인에는 지원되지 않습니다.

이 메서드는 기능/옵션 키워드(keyword) 쌍 목록을 사용하여 드라이버의 기능 설정을 위해 호출됩니다. 호출자는 IPrintCoreUI2::GetOptions 메서드를 사용하여 결과 기능 설정에 액세스할 수 있습니다.

이 메서드가 S_OK 이외의 값을 반환하는 경우 드라이버의 기능 설정을 변경하지 않았습니다.

pmszFeatureOptionBuf 입력 버퍼는 IPrintCoreUI2::GetOptions 메서드의 출력 버퍼와 동일한 방식으로 생성되어야 합니다. 즉, 기능/옵션 키워드(keyword) 쌍은 MULTI_SZ 형식이어야 하며 목록의 각 항목은 다음 항목과 null 문자로 구분됩니다. null 문자 쌍이 목록을 종료합니다.

입력 버퍼에 인식되지 않는 기능 키워드(keyword) 또는 해당 옵션 키워드(keyword) 포함되어 있거나 기능이 인식되지만 현재 고정 모드에서 지원되지 않는 경우(Driver-Supplied 속성 시트 페이지 바꾸기 참조) 기능/옵션 쌍이 무시되고 해당 기능에 대한 현재 옵션이 계속 적용됩니다.

이 메서드는 핵심 드라이버의 표준 UI 페이지를 완전히 대체하는 UI 플러그 인에 대해서만 지원되며 UI 플러그 인의 IPrintOemUI::D ocumentPropertySheets 및 IPrintOemUI::D evicePropertySheets 함수 및 해당 속성 시트 콜백 루틴 중에만 지원됩니다.

자세한 내용은 GetOptions 및 SetOptions 사용을 참조하세요.