GetContextPropertyValue 함수(recapis.h)

인식기 컨텍스트에서 지정된 속성 값을 반환합니다.

구문

HRESULT GetContextPropertyValue(
  HRECOCONTEXT hrc,
  GUID         *pGuid,
  ULONG        *pcbSize,
  BYTE         *pProperty
);

hrc

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

pGuid

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

pcbSize

입력에서 pProperty 버퍼의 크기(바이트)가 될 수 있습니다. 출력에서 pProperty 버퍼의 크기(바이트)입니다.

pProperty

사용자가 속성 값을 포함하도록 버퍼를 할당했습니다. 버퍼의 크기를 확인하려면 pProperty 를 NULL로 설정합니다. pProperty를 할당하려면 크기를 사용합니다.

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

반환 코드	Description
S_OK	성공.
E_POINTER	매개 변수 중 하나가 잘못된 포인터입니다.
E_FAIL	지정되지 않은 오류가 발생했습니다.
E_INVALIDARG	잘못된 인수가 수신되었습니다.
TPC_E_UNINITIALIZED_PROPERTY	속성이 컨텍스트에 의해 설정되지 않았습니다. 이는 속성이 특정 상황에서만 설정되었거나 아직 발생하지 않은 이벤트 후에만 속성을 설정해야 하는 경우에 발생할 수 있습니다.
TPC_E_INVALID_PROPERTY	인식기가 속성을 지원하지 않습니다.
TPC_E_INSUFFICIENT_BUFFER	pProperty 버퍼가 너무 작습니다.

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

GetContextPropertyValue 함수를 사용하여 인식기가 호출자에게 반환하는 정보를 가져올 수 있습니다. 이렇게 하면 사용자 지정된 인식기에서 모드 및 설정을 사용하고 해당 인식기에서 고유한 데이터를 반환할 수 있습니다.

Microsoft 인식기에서 pcbSize 매개 변수가 필요보다 큰 값으로 설정된 GetContextPropertyValue 함수를 호출해도 반환 값이 잘못되지 않습니다. 대신 코드는 크기를 현재 GUID에 필요한 값으로 자동으로 변경합니다.