WsMatchPolicyAlternative 함수(webservices.h)

  • 아티클

정책 대안이 지정된 정책 제약 조건과 호환되는지 확인합니다. 대안이 호환되는 경우 제약 조건 구조는 정책 정보로 채워집니다.

참고 제약 조건 구조에 대한 자세한 내용은 이 페이지의 설명을 참조하세요.

 

구문

HRESULT WsMatchPolicyAlternative(
  [in]           WS_POLICY             *policy,
  [in]           ULONG                 alternativeIndex,
  [in]           WS_POLICY_CONSTRAINTS *policyConstraints,
  [in]           BOOL                  matchRequired,
  [in]           WS_HEAP               *heap,
  [in, optional] WS_ERROR              *error
);

매개 변수

[in] policy

대안이 포함된 WS_POLICY 개체에 대한 포인터입니다.

참고WsGetMetadataEndpoints에서 반환되는 각 WS_METADATA_ENDPOINT 정책 개체를 포함합니다.
 

[in] alternativeIndex

정책 개체 내에서 사용할 대안을 식별하는 인덱스(0부터 시작)를 지정합니다. 정책 개체에 있는 대안의 수는 WsGetPolicyAlternativeCount를 사용하여 가져올 수 있습니다.

[in] policyConstraints

함수가 NOERROR를 반환하는 경우 채울 필드와 함께 일치시킬 정책을 지정하는 제약 조건에 대한 포인터입니다.

참고 속성 제약 조건이 지정되지 않은 경우 해당 특정 속성에 대한 기본 제약 조건 값이 사용됩니다.

자세한 내용은 WS_POLICY_CONSTRAINTS 참조하세요.

 

[in] matchRequired

일치 항목이 필요한지 여부를 나타냅니다.

참고 값이 FALSE 이면 일치가 필요하지 않으며 일치하지 않는 정책 대안과 함께 함수는 S_FALSE 반환합니다.

이 매개 변수의 값이 TRUE 이면 일치 항목이 필요하며 정책이 일치하지 않으면 함수는 오류를 반환합니다.

 

[in] heap

지정된 제약 조건을 초과하여 할당이 필요한 데이터를 저장하는 데 사용되는 Heap 개체에 대한 포인터입니다.

참고 예를 들어 제약 조건 "out" 필드 내의 포인터 형식은 이 힙을 사용하여 할당됩니다.
 

[in, optional] error

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

반환 값

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

반환 코드 설명
E_INVALIDARG
 하나 이상의 인수가 잘못되었습니다.
WS_E_INVALID_FORMAT
 정책 대안이 지정된 제약 조건을 충족하지 않으며 matchRequired가 TRUE로 설정되었습니다.

정책 또는 기타 메타데이터가 잘못된 형식이었습니다.
S_FALSE
 정책 대안이 지정된 제약 조건을 충족하지 않으며 matchRequired가 FALSE로 설정되었습니다.
S_OK
 정책 대안은 특정 제약 조건을 충족합니다. 제약 조건 구조의 out 필드는 정책의 값으로 채워졌습니다.

설명

이러한 각 데이터 형식에는 "out"이라는 구조체 필드가 포함되어 있습니다.

호출이 NOERROR를 반환하는 경우 이러한 구조체의 out 필드 내용이 이 함수에 의해 채워집니다.
참고 함수 호출이 실패하면 콘텐츠 가 부분적으로 설정되었을 수 있으며 지정된 힙 개체에서 일부 할당만 수행되었을 수 있습니다. 함수가 NOERROR를 반환하지 않는 한 out 필드의 내용을 검사하면 안 됩니다.

정책 개체는 이 함수가 호출될 때까지 일부 처리를 지연할 수 있습니다. 처리에 실패하면 정책 개체가 WS_POLICY_STATE_FAULTED 설정됩니다.

 

요구 사항

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