WsReadAttribute 함수(webservices.h)
지정된 WS_TYPE 값을 생성하는 특성을 읽습니다.
구문
HRESULT WsReadAttribute(
[in] WS_XML_READER *reader,
[in] const WS_ATTRIBUTE_DESCRIPTION *attributeDescription,
[in] WS_READ_OPTION readOption,
[in, optional] WS_HEAP *heap,
void *value,
[in] ULONG valueSize,
[in, optional] WS_ERROR *error
);
매개 변수
[in] reader
특성을 포함하는 요소에 배치된 판독기입니다.
[in] attributeDescription
특성을 역직렬화하는 방법에 대한 설명에 대한 포인터입니다.
[in] readOption
특성이 필요한지 여부와 값을 할당하는 방법입니다. 자세한 내용은 WS_READ_OPTION 참조하세요.
[in, optional] heap
역직렬화된 값을 저장할 힙입니다.
value
이 매개 변수의 해석은 WS_READ_OPTION 따라 달라집니다.
[in] valueSize
이 매개 변수의 해석은 WS_READ_OPTION 따라 달라집니다.
[in, optional] error
함수가 실패할 경우 추가 오류 정보를 저장할 위치를 지정합니다.
반환 값
이 함수는 이러한 값 중 하나를 반환할 수 있습니다.
반환 코드 | 설명 |
---|---|
|
입력 데이터가 예상 형식이 아니거나 예상 값이 없습니다. |
|
메모리가 부족합니다. |
|
힙의 크기 할당량을 초과했습니다. |
|
하나 이상의 인수가 잘못되었습니다. |
설명
이 API는 이름과 네임스페이스가 지정된 특성을 검색한 다음 형식화된 값으로 콘텐츠를 역직렬화합니다.
API가 실패하면 입력 판독기의 상태가 정의되지 않습니다. 이 경우 판독기에서 사용할 수 있는 유일한 API는 WsSetInput 및 WsSetInputToBuffer 를 사용하여 판독기를 사용 가능한 상태로 되돌리거나 WsFreeReader 를 사용하여 판독기를 해제합니다.
요구 사항
요구 사항 | 값 |
---|---|
지원되는 최소 클라이언트 | Windows 7 [데스크톱 앱 | UWP 앱] |
지원되는 최소 서버 | Windows Server 2008 R2 [데스크톱 앱 | UWP 앱] |
대상 플랫폼 | Windows |
헤더 | webservices.h |
라이브러리 | WebServices.lib |
DLL | WebServices.dll |