WsGetSecurityTokenProperty 함수(webservices.h)

  • 아티클

보안 토큰에서 필드 또는 속성을 추출합니다. 쿼리된 속성이 힙 매개 변수를 사용하지 않는 경우 반환된 데이터는 보안 토큰이 소유하며 보안 토큰 자체가 유효한 상태로 유지되는 한 유효한 상태로 유지됩니다. 특히 수신된 메시지에서 추출된 보안 토큰의 경우 메시지가 다시 설정되거나 해제되지 않는 한 해당 토큰에서 추출된 보안 토큰과 필드가 유효합니다.

속성에 힙 매개 변수가 필요한 경우 반환된 데이터는 힙에 저장되고 수명은 기본 토큰에서 분리됩니다.

구문

HRESULT WsGetSecurityTokenProperty(
  [in]           WS_SECURITY_TOKEN             *securityToken,
  [in]           WS_SECURITY_TOKEN_PROPERTY_ID id,
                 void                          *value,
  [in]           ULONG                         valueSize,
  [in, optional] WS_HEAP                       *heap,
  [in, optional] WS_ERROR                      *error
);

매개 변수

[in] securityToken

속성을 추출해야 하는 보안 토큰입니다.

[in] id

검색할 속성의 ID입니다.

value

검색된 속성을 저장할 위치입니다. 포인터는 속성 형식과 호환되는 맞춤이 있어야 합니다.

[in] valueSize

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

[in, optional] heap

추가 속성 데이터를 저장할 힙입니다. 쿼리된 속성이 WS_SECURITY_TOKEN_PROPERTY_SYMMETRIC_KEY 경우 이 매개 변수는 NULL이 아니어야 하며, 그렇지 않으면 NULL이어야 합니다.

[in, optional] error

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

반환 값

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

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

요구 사항

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