SetContextPropertyValue 함수(recapis.h)

인식기 컨텍스트에 속성을 추가합니다.

속성이 이미 있는 경우 해당 값이 수정됩니다.

구문

HRESULT SetContextPropertyValue(
  HRECOCONTEXT hrc,
  GUID         *pGuid,
  ULONG        cbSize,
  BYTE         *pProperty
);

hrc

인식기 컨텍스트에 대한 핸들입니다.

pGuid

설정할 속성입니다. 미리 정의된 속성 GUID(Globally Unique Identifier) 또는 애플리케이션 정의 속성 GUID를 지정합니다. 미리 정의된 속성 목록은 인식 속성 GUID를 참조하세요.

cbSize

pProperty 버퍼의 크기(바이트)입니다.

pProperty

속성 값이 포함된 버퍼입니다.

이 함수는 이러한 값 중 하나를 반환할 수 있습니다.

반환 코드	Description
S_OK	성공.
E_FAIL	지정되지 않은 오류가 발생했습니다.
E_POINTER	pGUID 가 잘못되었거나 cbSize 가 매우 크고 잘못된 값으로 설정되었습니다.
TPC_E_INVALID_PROPERTY	pGUID 가 잘못되었습니다.
E_INVALIDARG	cbSize 가 잘못되었습니다.
S_FALSE	이미 사용하도록 설정된 경우 속성 값을 설정하려고 하면 반환됩니다.

SetContextPropertyValue 함수는 선택 사항입니다.