WsGetMetadataProperty 함수(webservices.h)

지정된 WS_METADATA 개체 속성을 검색합니다. 검색할 속성은 WS_METADATA_PROPERTY_ID 입력 매개 변수로 식별됩니다.

참고 이 함수에서 반환된 데이터는 메타데이터 개체가 해제되거나 다시 설정될 때까지 유효합니다. 데이터를 수정하면 안 됩니다.

 

구문

HRESULT WsGetMetadataProperty(
  [in]           WS_METADATA             *metadata,
  [in]           WS_METADATA_PROPERTY_ID id,
                 void                    *value,
  [in]           ULONG                   valueSize,
  [in, optional] WS_ERROR                *error
);

매개 변수

[in] metadata

desired 속성을 포함하는 메타데이터 개체에 대한 포인터입니다. 이 매개 변수는 유효한 WS_METADATA 개체여야 합니다.

[in] id

검색할 속성의 식별자 값입니다.

value

검색된 속성 값을 저장하기 위한 위치에 대한 참조입니다. 포인터는 속성 형식과 호환되는 맞춤이 있어야 합니다.

[in] valueSize

검색된 속성 값을 저장하기 위해 호출자가 할당한 바이트 길이 버퍼 크기입니다.

[in, optional] error

함수가 실패할 경우 오류에 대한 추가 정보를 저장해야 하는 WS_ERROR 개체에 대한 포인터입니다.

반환 값

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

반환 코드	설명
E_INVALIDARG	이 개체에 대해 속성 ID가 지원되지 않았거나 지정된 버퍼가 값에 충분히 크지 않았습니다.
E_OUTOFMEMORY	메모리가 부족합니다.
기타 오류	이 함수는 위에 나열되지 않은 다른 오류를 반환할 수 있습니다.

요구 사항

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