IBTSTicket.ValidateAndRedeemTicket 메서드(COM)

  • 아티클

 

BizTalk 메시지와 연결된 자격 증명을 검색합니다.

구문

  
HRESULT ValidateAndRedeemTicket(  
IUnknown*  
punkMessage  
,  
BSTR  
bstrApplicationName  
,  
LONG  
lFlags  
,  
BSTR*  
pbstrExternalUserName  
,  
SAFEARRAY  
BSTR  
);  
  

  
HRESULT ValidateAndRedeemTicket(  
IUnknown*  
punkMessage  
,  
BSTR  
bstrApplicationName  
,  
LONG  
lFlags  
,  
BSTR*  
pbstrExternalUserName  
,  
SAFEARRAY  
BSTR  
);  
  

  
Function   
Ticket  
.ValidateAndRedeemTicket(  
punkMessage  
As Object,  
bstrApplicationName  
As String,  
lFlags  
As Long,  
pbstrExternalUserName  
As String  
)  
As String

매개 변수

punkMessage
[in] BizTalk Server 메시지를 지정합니다.

punkMessage
[in] BizTalk Server 메시지를 지정합니다.

bstrApplicationName
[in] 응용 프로그램 이름을 지정하는 문자열입니다. 이 매개 변수는 NULL 또는 빈 문자열일 수 없으며 공백을 포함할 수 없습니다. 응용 프로그램 이름은 대/소문자를 구분하지 않지만 대/소문자는 유지됩니다. "ABC", "abc" 및 "AbC"는 동일한 응용 프로그램으로 간주됩니다.

bstrApplicationName
[in] 응용 프로그램 이름을 지정하는 문자열입니다. 이 매개 변수는 NULL 또는 빈 문자열일 수 없으며 공백을 포함할 수 없습니다. 응용 프로그램 이름은 대/소문자를 구분하지 않지만 대/소문자는 유지됩니다. "ABC", "abc" 및 "AbC"는 동일한 응용 프로그램으로 간주됩니다.

lFlags
[in] 설정할 플래그를 지정하는 정수(Long)입니다. Enterprise Single Sign-On Flags 플래그를 사용하여 자격 증명 캐시를 바이패스합니다.

lFlags
[in] 설정할 플래그를 지정하는 정수(Long)입니다. Enterprise Single Sign-On Flags 플래그를 사용하여 자격 증명 캐시 무시

pbstrExternalUserName
[out] 외부 사용자 이름을 지정하는 문자열에 대한 포인터입니다.

pbstrExternalUserName
[out] 외부 사용자 이름을 지정하는 문자열입니다.

반환 값

이 메서드는 메서드가 성공적으로 완료되었는지 여부를 나타내는 HRESULT를 반환합니다. 자세한 내용은 오류 값 섹션을 참조하십시오.

외부 자격 증명을 포함하는 문자열 배열입니다.

예외

이 메서드는 다음 표에 있는 값 중 하나를 포함하는 HRESULT를 반환합니다.

이 메서드는 전역 Err 개체의 Number 속성을 다음 표에 있는 값 중 하나로 설정하여 오류를 나타냅니다.

값 설명
S_OK 메서드가 성공했습니다.
E_ACCESSDENIED 호출자에 대한 액세스가 거부된 경우
E_INVALIDARG 잘못된 매개 변수가 감지되었습니다.

설명

이 메서드는 티켓을 교환하기 전에 Microsoft® BizTalk® Server 메시지의 보낸 사람 ID가 티켓의 사용자 ID와 일치하는지 검증합니다.

이 메서드는 자격 증명을 일반 텍스트로 반환하므로 호출자는 자격 증명을 사용한 후 즉시 삭제(덮어쓰기)해야 합니다.

이 메서드에 액세스하려면 SSO 관리자, SSO 관련 관리자 또는 응용 프로그램 관리자여야 합니다.

예제

using System;  
using System.Runtime.InteropServices;  
  
namespace Microsoft.BizTalk.PublicInterop  
{  
   // Only include flags that apply to these interfaces  
   // See the ssoflags.idl file  
  
   internal enum BTSTicketFlags  
   {  
      SSO_FLAG_NONE      = 0,  
      SSO_FLAG_REFRESH   = 1  
   };  
  
   [ComImport]  
   [TypeLibType(TypeLibTypeFlags.FCanCreate)]  
   [ClassInterface(ClassInterfaceType.None)]  
   [Guid("8DA848D0-E703-4043-9AF7-C569AC1F4507")]  
   internal class BTSTicket  
   {  
   }  
  
   [ComImport]  
   [InterfaceType(ComInterfaceType.InterfaceIsDual)]  
   [Guid("54596C7F-D343-4F20-BF7A-0722C5DA1F7D")]  
   [CoClass(typeof(BTSTicket))]  
   internal interface IBTSTicket  
   {  
      string[] ValidateAndRedeemTicket(  
         [In, MarshalAs(UnmanagedType.IUnknown)] object message,  
         string applicationName,  
         int flags,  
         out string externalUserName);  
   };  
}  
Imports System  
Imports System.Runtime.InteropServices  
  
Namespace Microsoft.BizTalk.PublicInterop  
  
   ' Only include flags that apply to these interfaces  
   ' See the ssoflags.idl file  
  
   Friend Enum BTSTicketFlags  
      SSO_FLAG_NONE       = 0  
      SSO_FLAG_REFRESH    = 1  
    End Enum  
  
   <ComImport(), TypeLibType(TypeLibTypeFlags.FCanCreate), ClassInterface(ClassInterfaceType.None), Guid("8DA848D0-E703-4043-9AF7-C569AC1F4507")> _  
    Friend Class BTSTicket  
    End Class  
  
   <ComImport(), InterfaceType(ComInterfaceType.InterfaceIsDual), Guid("54596C7F-D343-4F20-BF7A-0722C5DA1F7D"), CoClass(GetType(BTSTicket))> _  
   Friend Interface IBTSTicket  
      Function ValidateAndRedeemTicket( _  
         <InAttribute, MarshalAs(UnmanagedType.IUnknown)> message As Object, _  
         ByVal applicationName As String, _  
         ByVal flags As Integer, _  
         <OutAttribute> externalUserName As String) As String()  
   End Interface  
End Namespace

요구 사항

플랫폼: Windows

참고 항목

IBTSTicket 인터페이스(COM)
IBTSTicket 멤버(COM)