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

아티클
02/07/2025

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

통사론

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

매개 변수

[in] poemuiobj

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

[in] dwFlags

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

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

[in] pmszFeatureOptionBuf

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

[in] cbIn

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

[out] pdwResult

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

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

반환 값

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

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

발언

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

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

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

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

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

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

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