wiasParseEndorserString 함수(wiamdef.h)

wiasParseEndorserString 함수는 보증자 문자열을 구문 분석하여 문자열의 WIA 서비스 정의 및 공급업체 정의 토큰을 해당 토큰과 연결된 값으로 바꿉니다.

구문

HRESULT wiasParseEndorserString(
  [in]            BYTE               *pWiasContext,
                  LONG               lFlags,
  [out, optional] WIAS_ENDORSER_INFO *pInfo,
  [out]           BSTR               *pOutputString
);

매개 변수

[in] pWiasContext

WIA 항목 컨텍스트(Microsoft Windows SDK 설명서에 설명된 WIA_DPS_ENDORSER_STRING 속성이 포함된 항목의 컨텍스트)에 대한 포인터입니다.

lFlags

시스템 사용을 위해 예약되며 0으로 설정해야 합니다.

[out, optional] pInfo

페이지 수와 사용자 지정 토큰/값 쌍 목록을 포함하는 WIAS_ENDORSER_INFO 구조체에 대한 포인터입니다. NULL일 수 있습니다.

[out] pOutputString

구문 분석된 보증자 문자열의 주소를 받는 메모리 위치에 대한 포인터입니다. 항목에서 *pOutputString 이 NULL이 아닌 경우 함수는 호출자가 버퍼를 할당한 것으로 가정합니다. 그렇지 않으면 WIA 서비스에서 할당합니다. WIA 서비스는 최대 결과 보증자 문자열이 MAX_PATH( stdlib.h에 정의됨) 문자 길이라고 가정합니다. 드라이버에서 문자열이 더 길어질 것으로 예상하는 경우 버퍼 자체를 할당해야 합니다. 호출자가 버퍼를 할당하는 경우 이 함수를 사용하기 전에 버퍼의 내용을 0으로 초기화 해야 합니다 .

반환 값

성공하면 함수는 S_OK 반환합니다.

함수가 실패하면 표준 COM 오류 또는 WIA 오류 코드 중 하나가 반환됩니다.

설명

애플리케이션은 WIA_DPS_ENDORSER_STRING 속성을 WIA 서비스 정의 토큰 $DATE$, $TIME$, $PAGE_COUNT$, $DAY$, $MONTH$, $YEAR$뿐만 아니라 공급업체에서 정의한 토큰을 포함할 수 있는 문자열로 설정합니다. 드라이버가 wiasParseEndorserString을 호출한 후 pOutputString 이 가리키는 문자열에는 WIA_DPS_ENDORSER_STRING 속성에 문자열 복사본이 포함되지만 토큰이 나타내는 값으로 대체된 토큰이 포함됩니다. 예를 들어 애플리케이션이 보증자 문자열을 "이 페이지가 $DATE$에서 스캔되었습니다"로 설정하고 현재 날짜가 2000년 10월 1일인 경우 결과 출력 문자열은 "이 페이지가 2000/10/1에 검색되었습니다"입니다.

표준 WIA 보증자 토큰 목록은 wiadef.h에서 찾을 수 있습니다.

드라이버는 각 토큰/값 쌍에 대한 WIAS_ENDORSER_VALUE 구조를 작성하고 이러한 구조를 모두 WIAS_ENDORSER_INFO구조체에 패키징하여 공급업체 정의 토큰의 대체 값을 wiasParseEndorserString에 요청할 수 있습니다. 다음 예제에서는 이 함수를 사용하는 방법을 보여줍니다.

HRESULT hr  = S_OK;
BSTR  bstrResultingEndorser   = NULL;
WIAS_ENDORSER_VALUE  aMyTokens[] = {L"$MY_TOKEN$", L"My value"};
WIAS_ENDORSER_INFO  Info     = {0, 1, aMyTokens};
hr = wiasParseEndorserString(pWiasContext, 0,
                             &Info, &bstrResultingEndorser);

WIA_DPS_ENDORSER_STRING 속성에 "this is $MY_TOKEN$"이 포함되어 있고 wiasParseEndorserString 에 대한 호출이 성공했다고 가정하면 bstrResultingEndorser 에는 이제 "This is My value"가 포함됩니다.

요구 사항

추가 정보

WIAS_ENDORSER_INFO

WIAS_ENDORSER_VALUE