WsFindAttribute 함수(webservices.h)

현재 요소의 특성을 검색하여 지정된 이름과 네임스페이스가 있는 특성을 검색하고 WsReadStartAttribute에 전달될 수 있는 인덱스를 반환합니다.

구문

HRESULT WsFindAttribute(
  [in]           WS_XML_READER       *reader,
  [in]           const WS_XML_STRING *localName,
  [in]           const WS_XML_STRING *ns,
  [in]           BOOL                required,
  [out]          ULONG               *attributeIndex,
  [in, optional] WS_ERROR            *error
);

매개 변수

[in] reader

특성을 찾을 판독기입니다.

[in] localName

검색할 특성의 로컬 이름입니다.

[in] ns

검색할 특성의 네임스페이스입니다.

[in] required

필수가 TRUE 이고 특성을 찾을 수 없는 경우 함수는 WS_E_INVALID_FORMAT 반환합니다. ( Windows Web Services 반환 값을 참조하세요.) 필수가 FALSE 이고 특성을 찾을 수 없는 경우 함수는 S_FALSE 반환합니다.

[out] attributeIndex

특성이 발견되면 특성의 인덱스가 여기에 반환됩니다. 그런 다음 이 인덱 스를 WsReadStartAttribute에 전달할 수 있습니다.

[in, optional] error

함수가 실패할 경우 추가 오류 정보를 저장할 위치를 지정합니다.

반환 값

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

반환 코드	설명
WS_E_INVALID_FORMAT	입력 데이터가 예상 형식이 아니거나 예상 값이 없습니다.

설명

판독기가 start 요소에 배치되지 않으면 WS_E_INVALID_OPERATION 반환됩니다. ( Windows Web Services 반환 값을 참조하세요.)

반환된 인덱스가 문서에 나타난 특성의 위치와 반드시 일치하지는 않습니다. WS_XML_ELEMENT_NODE 특성 배열에서 일치하는 특성의 인 덱스를 식별합니다. 이 배열의 특성 순서는 문서에 특성이 나타난 순서와 다를 수 있습니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 7 [데스크톱 앱 | UWP 앱]
지원되는 최소 서버	Windows Server 2008 R2 [데스크톱 앱 | UWP 앱]
대상 플랫폼	Windows
헤더	webservices.h
라이브러리	WebServices.lib
DLL	WebServices.dll